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About IBM Content Manager OnDemand for iSeries 
Administration Guide (SC41-5325) 


This information shows you how to use and administer the IBM Content Manager 
OnDemand for iSeries (OnDemand) licensed program. OnDemand (known as 
Report/Data Archive and Retrieval System or R/DARS in previous releases) lets 
you store large amounts of historical data onto a disk, high-capacity optical 
volumes, or tape. It also provides quick access to stored data by on-line retrieval. 


Use of the instructions and examples that are provided give guidance for 
performing the following tasks: 


* To define and create archives. 
* To grant and revoke access to data. 
* To display, print, or send facsimiles of your documents. 


By using this manual, you can optimize your media usage with a combination of 
disk, optical, and tape media. 


Who should read this book 


This book is for programmers, OnDemand administrators, and end users who are 
responsible for creating, maintaining, and using OnDemand to archive and retrieve 
information. 


Prerequisite and related information 


Use the IBM iSeries Information Center as your starting point for looking up 
iSeries technical information. 


You can access the Information Center two ways: 
* From the following Web site: http://www. ibm.com/eserver/iseries/infocenter 
* From CD-ROMs that ship with your Operating System/400® order: 

iSeries Information Center, SK3T-4091-02. This package also includes the PDF 


versions of iSeries manuals, iSeries Information Center: Supplemental Manuals, 
SK3T-4092-01, which replaces the Softcopy Library CD-ROM. 


The Information Center contains advisors and important topics such as Java’, 
TCP/IP, Web serving, secured networks, logical partitions, clustering, CL 
commands, and system application programming interfaces (APIs). It also includes 
links to related IBM Redbooks™ and Internet links to other IBM Web sites such as 
the IBM home page. 


| iSeries Navigator 


| IBM iSeries Navigator is a powerful graphical interface for managing your iSeries 

| servers. iSeries Navigator functionality includes system navigation, configuration, 

| planning capabilities, and online help to guide you through your tasks. iSeries 

| Navigator makes operation and administration of the server easier and more 

| productive and is the only user interface to the new, advanced features of 

| OS/400®. It also includes Management Central for managing multiple servers from 
| a central system. 
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You can find more information on iSeries Navigator in the iSeries Information 
Center and at the following Web site: 
http://www. ibm.com/eserver/iseries/navigator/ 


How to send your comments 


Your feedback is important in helping to provide the most accurate and 
high-quality information. If you have any comments about this book or any other 
iSeries documentation, fill out the readers’ comment form at the back of this book. 


* If you prefer to send comments by mail, use the readers’ comment form with the 
address that is printed on the back. If you are mailing a readers’ comment form 
from a country other than the United States, you can give the form to the local 
IBM branch office or IBM representative for postage-paid mailing. 


* If you prefer to send comments by FAX, use either of the following numbers: 
— United States, Canada, and Puerto Rico: 1-800-937-3430 
— Other countries: 1-507-253-5192 
* If you prefer to send comments electronically, use one of these e-mail addresses: 
— Comments on books: 
RCHCLERK @us.ibm.com 
IBMMAIL, to IBMMAIL(USIB56RZ) 
— Comments on the iSeries Information Center: 
RCHINFOC@us.ibm.com 


Be sure to include the following: 

¢ The name of the book. 

* The publication number of the book. 

* The page number or topic to which your comment applies. 
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| Summary of Changes 


This edition of IBM Content Manager OnDemand for iSeries: Administration Guide 
contains new and changed technical information. There may be some instances 
where changes were made, but change bars are missing. Significant changes to 
note are: 


You can automate the loading of non-spooled file data such as PC files in IFS with 
the Start Monitor for OnDemand (STRMONOND) command using *DIR (directory) 
for the TYPE parameter. See Appendix A of the IBM Content Manager OnDemand for 
iSeries Common Server: Administration Guide for information on the STRMONOND 
command. 


Additional keywords have been added to many OnDemand commands to more 
precisely identify the spooled file that the command will use. The new keywords 
correspond to the same new keywords available for OS/400 spooled file 
commands, allowing you to specify the system on which the spooled file was 
created, as well as the spooled file creation date and time. 


Portable Application Solutions Environment (PASE), a product option of OS/400, is 
now an optional software prerequisite for the OnDemand Common Server. PASE is 
required if you plan to use the new OnDemand Common Server text search 
function for AFPDS documents. It is also possible that, in the future, other new 
functions of OnDemand may require PASE. 


Additions and enhancements have been made to the sample programs for both 
Common Server and Spool File Archive. Sample programs for Common Server can 
be found in QSAMPLES2 source file in library QRDARS. Sample programs for 
Spool File Archive can be found in QSAMPLES source file in library QRDARS. 


Record Archive provides commands and application programming interfaces 
(APIs) that let you store and retrieve data records on optical media for users who 
only require occasional access to historical data. At Version 5 Release 2, this 
product option is provided for existing Record Archive customers to use, but there 
are no planned enhancements. Documentation can be found in OnDemand 
publications from previous releases. Please talk to your software provider about 
other options, such as compressed DASD. 
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Chapter 1. Using the OnDemand Spool File Archive Feature 


The OnDemand Spool File Archive feature provides report capture, segmentation, 
indexing, compression, storage, retrieval, and print/facsimile capabilities for print 
(spooled) data. 


As the system administrator, you are responsible for migrating your data to 
OnDemand and for developing standard procedures for your users. Careful 
planning can ensure a smooth transition from your current methods to 
state-of-the-art archiving and retrieval. We suggest that you carefully read Chapter 
4 of IBM Content Manager OnDemand for iSeries Installation Guide before you begin. 


To add Spool File Archive functions to your existing applications (either as a menu 


erated with existing functions), see|Appendix A, “OnDemand Spool 


File Archive User Exits and Application Programming Interfaces” on e 291 


Steps to Follow When Defining a Report 


Below is a summary of the steps to follow when defining a report to OnDemand. 
1. Look at the printed report. 


* How long do you want to keep the report on disk/optical/tape? (In other 
words, what report policy should the report definition use?) Create a 
storage group and policy if one does not already exist that meets your 
requirements. 


* What kind of report is it? 

- DOC - with logical segments 

— PAGE - with key value in ascending sequential order 

— NODxX - with no order or no need to define keys. 

— UBND - a combination of unrelated reports all in one spooled file. 
* How is the report segmented? 

— DOC - what is the logical break between segments? 


— PAGE or NODX - what literal is always on the first page? (You specify 
where the report starts and the number of pages per segment; 
OnDemand creates the segments for you). 


— UBND - each report receives its own definition, which determines the 
division into pieces. 
* What are the keys to the segments? 
- DOC - up to 5 keys and display fields 
— PAGE - key 1 and key 2 are the same (the field that is in ascending 
order). 
— NODX - no user-defined keys 
— UBND - each report receives its own definition, which determines the 
keys 
* What report date to you want to use? (Job date or date printed on report). 
2. To work from the OnDemand menus, enter GO ONDEMAND or GO 
RDARS from a command line, then select option 1 for Report Administration, 
and then option 20 for the Report Definition Menu. 
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3. Work with the output queue that contains the report you wish to define. Press 
F11 to display the spooled file attributes, and write down or print the screen 
to record the following information: 


* Spooled file name 

* Job name 

* User 

¢ Job number 

* Spooled file number 


4. Create a printer file if your printing and faxing requirements vary from the 
standard printer file attributes in the OnDemand default printer file 
(QPRLR133 in QRDARS library). Consider the following: 


* Form type 

* User data 

* Front side overlay and Back side overlay names 

* Overlay offsets 

* Characters per inch or Lines per inch (CPI or LPI) 
* Page size Length and Width 


5. Copy the spooled file to a physical file or use iSeries Navigator to work with 
the spooled file data graphically. Alternatively, you can use the OnDemand 
Advanced Function Presentation’” data stream (AFPDS) print text function if 
spooled file is AFPDS. 


* Where are the fields on the report? 
— Absolute line number and column number 
— Pivot processing 


— Translate print control (If using this method, use it for all fields within 
the report definition.) 


6. Write the information on the report definition work sheets (optional) and enter 
it into OnDemand. Alternatively, you can use iSeries Navigator to define the 
report with a graphical user interface. 


7. Store the report. 


8. Check the report store completion report to verify successful report store, 
number of segments, compression, elapsed time to store, and so forth. 


9. Test the retrieval of the report to confirm index (key) values were extracted as 
expected. 


10. Create report overlays for viewing (and optionally to print or fax) if desired. 
11. Set up the correct authorizations to secure the report. 


Details on all of these functions are included in this chapter. 


OnDemand Administration Graphical User Interface 
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OnDemand provides Windows® workstation users with an alternative to the 5250 
data entry screens for working with Report Definitions (and many other 
OnDemand Administration functions) that are_described in this chapter. The iSeries 


Navigator provides the interface as shown in|Figure 1 on page 3 


IBM Content Manager OnDemand for iSeries: Administration Guide 


=) Primary Environment 
=f Rdr400c 
#45 Basic Operations 
2B) Security 
+) ga Users and Groups 
) ag OnDemand Archive 
=}-4] Report Administration 
Ei] Report Definitions 
ig] Report Groups 
£@ Migration Policies 
Eh Screen Overlays 
eI Media Administration 
@& Tape Devices 
Tape Volumes 
& Optical Storage Groups 
Optical Volumes 


Figure 1. iSeries Navigator interface screen 


One of the most powerful features of iSeries Navigator is that it allows report 
administrators to work with report definitions and spooled file data by using a 


graphical user interface. The OS/400 spooled file data displays in a window on the 


workstation that the report administrator can click on to identify division criteria, 


report date, and key fields. You can select other definition attributes such as report 


type, data type, and migration policy information by using pulldown select boxes. 
The graphical interface is a very productive way to work with Report Definitions 
and perform other OnDemand administrative tasks. Online help information is 
available on all the workstation panels. However, it is recommended that you 
become familiar with OnDemand concepts as described in this chapter before 
using this tool. 


Report Administration Menu 


To Access the Report Administration Menu, you can type: 


* 1 on the OnDemand for iSeries Main Menu command line, 


* Or type the Fast-Path command: 


GO RDARSRPT 


on the OS/400 command line, for direct access to|Figure 3 on page 4 


* Or use iSeries Navigator for a graphical user interface to many of the functions 
described in this chapter. 


Access the OnDemand main menu, |Figure 2 on page 4 


Chapter 1. Using the OnDemand Spool File Archive Feature 


3 


ONDEMAND OnDemand for iSeries 
System: | ONDMD400 
Select one of the following: 


Report Administration Menu 
Object Administration Menu 
Record Archive Menu 

Media Administration Menu 


PwWNre 


90. Signoff 


Selection or command 
e=s=>] 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel  F13=Information Assistant 
F16=System Main Menu 
(C) Copyright IBM Corp. 1992, 2000. All Rights Reserved. 


Ne 


Figure 2. OnDemand for iSeries Main Menu 


When you select option 1, the Report ADMINISTRATION MENU, [Figure 3] appears. 


ONDMDRPT OnDemand Report Administration Menu 
System: ONDMD400 
Select one of the following: 


1. Retrieve Reports 

2. Work with Report Policies 

3. Work with Report Overlays 

4. Work with Report Definitions 

5. Work with Report Groups 

6. Work with Report Definition Extensions 


10. Edit/Authorize OnDemand Users 

11. Edit/Authorize OnDemand Report Users 

12. Edit/Authorize OnDemand Report Group Users 
13. Work with Key Security 


20. Report Definition Menu 


More... 
Selection or command 
===> 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=Information Assistant 
F16=System Main Menu 
ee Copyright IBM Corp. 1992, 2000. All Rights Reserved. 


Figure 3. OnDemand Report Administration Menu 


For additional options, you_can press Page Down from this screen to go to the 
screen shown in 
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ONDMDRPT OnDemand Report Administration Menu 
System: | ONDMD400 
Select one of the following: 


21. Report Utility Menu 
22. OnDemand Main Menu 


30. Change OnDemand Global Report Options 
31. Change Your OnDemand Report Options 
32. Change OnDemand Report Options 


40. Report Definition Export/Import 


Bottom 
Selection or command 
===> 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
F1l6=System Main Menu 
i) Copyright IBM Corp. 1992, 2000. All Rights Reserved. 


Figure 4. OnDemand Report Administration Menu (continued) 


These two screens show you all the options that are explained in this chapter and 
do not repeat in the text. 


Option 1. Retrieve Reports 
Retrieving reports is an end-user function, and is described in|Chapter 8, “For the 
OnDemand Spool File Archive End User” on page 277 


Option 2. Work with Report Policies 


You must assign a report policy to each report. The report policy is used as input 
during the Report Management Cycle to determine which media the system stores 
the report on, and for what length of time. Multiple reports can use the same 
report policy. 


Your initial estimates for Days allowed on disk, Days allowed on tape, and Days allowed 
on optical can be modified after OnDemand has collected historical data related to 


actual report usage statistics. See|“Usage Statistics Reports” on page 139] for 


instructions to generate reports of actual report usage. 


To define a report policy, select option 2, Work with Report Policies, from the 
Report ADMINISTRATION MENu, |Figure 3 on page 4} or use iSeries Navigator for a 


graphical user interface to this function. 


Figure 5 on page 6] Work witH ADMIN FOR ONDEmMAND (WRKADMRDAR) appears. 
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Work with Admin for OnDemand (WRKADMRDAR) 
Type choices, press Enter. 
Administrator function. .... >*RPTPCY *REPORT, *RPTGRP, *RPTOVL... 
Report policy os sos 6 a Ge we GS *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 5. Work with Admin for OnDemand (WRKADMRDAR) 


Press Enter to move to Work wiTH Report Poticies screen. Use it to create, 


change, delete, or display report policies. 


To Create a Policy 
Use [Figure 6] to add a policy name record. 


'@ Work with Report Policies ONDMD400 
1/31/98 15:08:54 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Option Policy Text 
1 D300PTICAL 
BRMS BRMS/400 Test policy 
DISKONLY Reports on disk only 
DOOPTICAL Move to optical right away 
DOOPTICALB 0 days on disk, use another storage group 
DOOPTTAPBK Migrate to optical fast with tape backup 
DOTAPE Disk 0 days and the tape 
DOTAPEBIG Use tap06 
DOTAPEJLS 
D9OOPTICAL DASD for 90 days then Optical (OnDemand Example) 
D9OTAPE DASD for 90 Days then to Tape (OnDemand Example) 
EXPIRE Expiration Test Policy 
LAN3995 Policy for lan testing 
More... 
F3=Exit F5=Refresh  F12=Cancel 


XX 


Figure 6. Work with Report Policies 


Press Enter to move to 
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Create Report Policy ONDMD400 
1/31/98 15:09:43 
Type choices, press Enter. 


PO MiCVieen ttatsnt-custeeracises ven keareaiea roars D300PTICAL Name 

Days allowed on disk ........ 30 0-9999999 
Days allowed on tape ........ 0 0-9999999 
Days allowed on optical. ...... 3620 0-9999999 
Expire: after days. <= «030 ss we eos 3650 1-9999999 
Recalil) retention 2. =e). seen She 5 0-999 
Tapeimedia. types... oc.) cave an ee oe aa 

Optical storage group. ....... RDAROPT____— Name 
Tndex:-days.soncdtSk: 50. ve. espe, Se 365 1-9999999 
Index recall retention ....... 5: 0-999 
Force index: atfimitty .. s. s S) se Y Y=Yes, N=No 
Tape backup requested ........ N Y=Yes, N=No 
Optical backup requested ...... N Y=Yes, N=No 
MOXIE Ge cel: Gen feleee seeder cor teu ton ten So Sh oe: ce Keep on Disk for 30 days, Expire 


after 10 years__ 


F3=Exit F12=Cancel 
\ y 


Figure 7. Create Report Policy 


Note: Never enter a number in the Index days on disk field that is less than the 
number of days you want to keep the report. Archiving index records to 
optical or tape using this method causes potential loss of visibility to the 
report data relating to those index records. 

* OnDemand will only search on disk for the index records of reports 
whose dates differ from the original report date when the following 
conditions occur. 


— The end users retrieve reports with the FNDRPTRDAR API. 


— The date range on the Speciry Document SgarcH screen is broadened 
(after entering a search key value). 


This is by design; otherwise it could cause an optical disk or tape mount 
for every volume on which OnDemand has index records stored. 


* If you use the FNDKEYRDAR API, the API will only search the index 
records on disk. This is by design; otherwise it could cause an optical 
disk or tape mount for every volume on which OnDemand has index 
records stored. 

* If you use the OnDemand Client, the OnDemand Server will only search 
the index records on disk. This is by design; otherwise, it could cause an 
optical disk or tape mount for every volume on which OnDemand has 
index records stored. 


For these reasons, you should only plan to migrate your index records to optical or 


to tape for long-term storage, when end users are not likely to need access to the 
report data under the above circumstances. 


Press Enter to save your entries and move to|Figure 8 on page 8 
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(a 


Work with Report Policies ONDMD400 
1/31/98 15:11:54 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 

Option Policy Text 

BRMS BRMS/400 Test policy 

DISKONLY Reports on disk only 

DOOPTICAL Move to optical right away 

DOOPTICALB 0 days on disk, use another storage group 

DOOPTTAPBK Migrate to optical fast with tape backup 

DOTAPE Disk 0 days and the tape 

DOTAPEBIG Use tap06 

DOTAPEJLS 

D9OOPTICAL DASD for 90 days then Optical (OnDemand Example) 

D9OTAPE DASD for 90 Days then to Tape (OnDemand Example) 

EXPIRE Expiration Test Policy 

LAN3995 Policy for lan testing 

More... 

F3=Exit F5=Refresh  F12=Cancel 
Policy created, F5 for Refresh. 


Figure 8. Work with Report Policies 


This screen confirms the addition of your report policy. 


Press F5 to display your addition. 


To Change a Report Policy 


Use this screen, to change the attributes of an existing report policy. 


( Work with Report Policies ONDMD400 
1/31/98 15:12:01 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Option Policy Text 
BRMS BRMS/400 Test policy 
DISKONLY Reports on disk only 
DOOPTICAL Move to optical right away 
DOOPTICALB 0 days on disk, use another storage group 
DOOPTTAPBK Migrate to optical fast with tape backup 
DOTAPE Disk 0 days and the tape 
DOTAPEBIG Use tap06 
DOTAPEJLS 
2 D300PTICAL Keep on Disk for 30 days, Expire after 10 years 
D9OOPTICAL DASD for 90 days then Optical (OnDemand Example) 
D9OTAPE DASD for 90 Days then to Tape (OnDemand Example) 
EXPIRE Expiration Test Policy 
More... 
F3=Exit F5=Refresh  F12=Cancel 


\ 


Figure 9. Work with Report Policies 


Press Enter to move to|Figure 10 on page 9 
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Change Report Policy ONDMD400 
1/31/98 15:12:32 
POWdiGy” sa eee et eres are et eee Soe ey ewe -DSOOPTICAL 
Type choices, press Enter. 
Days allowed on disk . 2.4. «4% « 48 30 0-9999999 
Days alllowed on tape «2% 3.034 4 0 0-9999999 
Days: allowed on optical... . 24 « « 3623 0-9999999 
Expiiresahbencdays: s, <r :0 ses ve. s. s8 oh coutes m) ce 3653 1-9999999 
Recall metention) occa s.ces een et oe cee 5 0-999 
Tapermediarty pert: irc. + ve. seecseeeeete an ue te 
Optical storage ‘group. ¢. .. 3.4) 6s ee RDAROPT_ Name 
Dndex days oniedisk fs fs. 5s: sess cet 0s cst eee 365 1-9999999 
Index recall retention ......... 5 0-999 
Force index -afittnity «2% 3 <4 .% 448 if Y=Yes, N=No 
Tape backup requested .......... N Y=Yes, N=No 
Optical backup requested ........ N Y=Yes, N=No 
MCXGAPe are ied Mier csecurcaeee ack amt ch hvac Keep on Disk for 30 days, Expire 
after 10 years 
F3=Exit F12=Cancel 
y 
Figure 10. Change Report Policy 
Type your changes over the current fields. Press Enter to display 
pag which confirms your changes. 
To Delete a Report Policy 
Use to delete a report policy record. 
ie ie % 
Work with Report Policies ONDMD400 
1/31/98 15:13:51 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Option Policy Text 
BRMS BRMS/400 Test policy 
DISKONLY Reports on disk only 
DOOPTICAL Move to optical right away 
DOOPTICALB 0 days on disk, use another storage group 
DOOPTTAPBK Migrate to optical fast with tape backup 
DOTAPE Disk 0 days and the tape 
DOTAPEBIG Use tap06 
DOTAPEJLS 
4 D300PTICAL Keep on Disk for 30 days, Expire after 10 years 
D9QOPTICAL DASD for 90 days then Optical (OnDemand Example) 
D9OTAPE DASD for 90 Days then to Tape (OnDemand Example) 
EXPIRE Expiration Test Policy 
More... 
F3=Exit F5=Refresh  F12=Cancel 
& 4 


Figure 11. Work with Report Policies 


Press Enter to continue to|Figure 12 on page 10 
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Confirm Delete of Policy ONDMD400 
1/31/98 15:34:53 
Press Enter to confirm your choice for 4=Delete. 
Press Fl2=Cancel to return to change your choice. 
RONTGY > (one exe See oss ee ee ee IDSZOOPITCAL 
Days-alilowed:omdisk 3: 6 fe a 30 0-9999999 
Days allowed on tape .........32 ) 0-9999999 
Days: allowed on: optical «<< ss. 6% 4 3623 0-9999999 
Expine:attercdays:<.ccss tae. 0, seus se cous ace 3653 1-9999999 
Recall ‘retention’ 2.08 oe eo oe 5 0-999 
Tapec media types. a2. Sst GS ie eo 8 
Optical storage group. ...... .. : RDAROPT Name 
Tndexsdays-omcdisk> so i28%. ce so ane 365 1-9999999 
Index recall] retention ........: 5 0-999 
Force: iindex affinity sos. sce ee OY Y=Yes, N=No 
Tape backup requested .........: +N Y=Yes, N=No 
Optical backup requested ....... : ON Y=Yes, N=No 
MOXG. a. ciel ve. He. cel Gone ay ys, sees oe Ge ee Keep. on: Disk “for=30:days. Expire 
after 10 years 
F12=Cancel 
e/ 
Figure 12. Confirm Delete of Policy 
Press Enter to delete the report policy and continue to or F12 to cancel 
the request. 
A message at the bottom of the screen confirms the deletion. 
a 
Work with Report Policies ONDMD400 > 
1/31/98 15:13:51 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Option Policy Text 
BRMS BRMS/400 Test policy 
DISKONLY Reports on disk only 
DOOPTICAL Move to optical right away 
DOOPTICALB 0 days on disk, use another storage group 
DOOPTTAPBK Migrate to optical fast with tape backup 
DOTAPE Disk 0 days and the tape 
DOTAPEBIG Use tap06 
DOTAPEJLS 
D300PTICAL Keep on Disk for 30 days, Expire after 10 years 
D9OOPTICAL DASD for 90 days then Optical (OnDemand Example) 
D9OTAPE DASD for 90 Days then to Tape (OnDemand Example) 
EXPIRE Expiration Test Policy 
More... 
F3=Exit F5=Refresh  F12=Cancel 
Policy is deleted. 
e 


Figure 13. Work with Report Policies 


If any reports have been defined to use a particular policy name, OnDemand 
protects you from deleting that policy; it issues a message that the policy cannot be 
deleted because one or more report definitions refer to it. 


Press F5 to view the list of remaining policies. 
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To Display a Report Policy 


Use |Figure 14} to view a report policy. 


a ; a * 
Work with Report Policies ONDMD400 
1/31/98 15:13:34 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Option Policy Text 
BRMS BRMS/400 Test policy 
DISKONLY Reports on disk only 
DOOPTICAL Move to optical right away 
DOOPTICALB 0 days on disk, use another storage group 
DOOPTTAPBK Migrate to optical fast with tape backup 
DOTAPE Disk 0 days and the tape 
DOTAPEBIG Use tap06 
DOTAPEJLS 
5 D300PTICAL Keep on Disk for 30 days, Expire after 10 years 
D9OOPTICAL DASD for 90 days then Optical (OnDemand Example) 
D9OTAPE DASD for 90 Days then to Tape (OnDemand Example) 
EXPIRE Expiration Test Policy 
More... 
F3=Exit F5=Refresh  F12=Cancel 
Policy changed. 
Figure 14. Work with Report Policies 
Press Enter to move to 
a 
Display Report Policy ONDMD400 +) 
1/31/98 15:13:42 
POWYS cuter telee sd es res ea cadens eee) DSOORTICAL 
Days:-alllowed :onicdisk 0 ssa 30 
Days ‘allowed on tape «<<. ..26.%6% 0 
Daysalilowed :on-optiical +... 4002405 ~ a ane 3623 
Expairenahten days: © c%0 ny aves tie es cs a0 es 3653 
ReGailill netemtioni: <2 0s ses cess Ges se ee 5 
Tape mediiaty peste ca.) a. wrveee. crate ea cane 
Optical storage: group «<<. .- 3 <%= % * RDAROPT 
Index: idaysoni disk: joc8 305.0: os Se 365 
Index: recall retention: <0... 06.2 4.24 «3 5 
Force: index affinity <3 a3 4 ee we OY Y=Yes, N=No 
Tape backup requested ..........2: 4%N Y=Yes, N=No 
Optical backup requested ........: N Y=Yes, N=No 
TOXt. 2 ee ee ee SS ee & & (Keep on Disk: for 30 days; Expire 
after 10 years 
Bottom 
Press Enter to continue. 
F3=Exit F12=Cancel 
yy 
Figure 15. Display Report Policy 
This screen displays the attributes of the report policy you selected. 
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You can create character-based report overlays, which combine with the spooled 
data when displayed. You can also include a report overlay when you print the 
data or send a facsimile. 


You can use a report overlay to simulate a preprinted form. For example, design a 
box of dashes to appear around a ship-to address, and add the words Ship-To 
Address above the box of dashes. When the user displays the report, the spooled 
file data, the box of dashes around the address on the page, and the Ship-To 
Address appear. 


It is important to understand the difference between an OnDemand character-based 
overlay and an Advanced Function Presentation (AFP'’) overlay. 


* OnDemand character-based overlays are created within OnDemand. They 
contain character data that is combined with report data when you view the 
report data from a 5250 display. (You can also print or fax character-based 
overlays.) 


* AFP overlays are defined outside of OnDemand and can contain company logos, 
shading, special fonts, and others. They are associated with OnDemand reports 
when you name them in a printer file that you identify in the report definition. 
AFP overlays are displayed when using the OnDemand Client to view report 
data. 


This section discusses character-based overlays. See “Option 4. Work with Report 


Definitions” on page 18]for a description of the Printer file field. 


You cannot define OnDemand character-based report overlays for AFPDS spooled 
data. 


To create, change, delete, or display a report overlay line, select option 3, Work 
with Report Overlays, from the ONDEMAND Report ADMINISTRATION MENU, 


Alternatively, you can use iSeries Navigator for a graphical user interface to 


this function. Press Enter to move to Work wiTtH ADMIN FOR ONDEMAND 


(WRKADMRDAR), [Figure 16 on page 13 
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#2 


Work with Admin for OnDemand (WRKADMRDAR) =) 
Type choices, press Enter. 
Administrator function. .... >*RPTOVL *REPORT, *RPTGRP, *RPTOVL... 
Report: overlay >< «3. <8 SG *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 16. Work with Admin for OnDemand (WRKADMRDAR) 


Press Enter to move to Work WITH Report Overtays, [Figure 17] Use this screen to 
create, change, delete, or display overlay lines. 


To Create a Report Overlay Line 


A report overlay lets you temporarily add character data to your spooled data for 
viewing, printing, or sending a facsimile. To create overlay lines, use 


‘a ; > 
Work with Report Overlays ONDMD400 


1/31/98 15:31:36 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Overlay Action Line Overlay data 
IT SIM. ee 
ABC IL 001 


Bottom 


F3=Exit F5=Refresh F12=Return 


Figure 17. Work with Report Overlays 


The Work witH Report OverLAys screen lists all of the overlay lines in OnDemand. 


Press Enter to move to CREATE Report Overtay Linz,|Figure 18 on page 14 
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a 
Create Report Overlay Line ONDMD400 ) 
1/31/98 15:31:54 


Type choices, press Enter. 


OVERT AY: 2 ok. Sey el ae STMT. Name 
ACTON weatey uss sees seyes ee ents cD IL=Insert line 
CD=Change data 
IMG. ea re ey eo se se 8 1-256 
Starting! columns. os. ce Goce cs 11 1-255 
Overlaydatas 0%: ee es Name: Date: 


F3=Exit F12=Cancel 
Ne” / 


Figure 18. Create Report Overlay Line 


Press Enter to move to 
i >) 


Work with Report Overlays ONDMD400 
1/31/98 15:33:08 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Overlay Action Line Overlay data 


ABC Nile 001 


Bottom 
F3=Exit F5=Refresh F12=Return 
Report overlay line created, F5 for Refresh. ) 


Figure 19. Work with Report Overlays 

This screen confirms the addition of your report overlay line. 

Press F5 to display your addition. Remember to use|“Option 4. Work with Report 
Definitions” on page 18]to update the Report overlay field of the Report Definition. 
If you do not do this final step, OnDemand will not know to use the Report 
Overlay with the report for which you designed it. 
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To Change a Report Overlay Line 


Use |Figure 20/to change an existing report overlay line. 


a E = 
Work with Report Overlays ONDMD400 
1/31/98 15:33:12 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Opt Overlay Action Line Overlay data 
ABC IL 601 
2 STMT CD 008 Name: Date: 
Bottom 
F3=Exit F5=Refresh F12=Return 
Figure 20. Work with Report Overlays 
Press Enter to move to|Figure 21 
a = 
Change Report Overlay Line ONDMD400 
1/31/98 15:33:26 
Overlay tec peter tears e ss sts ce) tetese ae COMI 
Type choices, press Enter. 
ACIONE eccuyeons: fatpe Misuse eerie) coarser cD IL=Insert line 
CD=Change data 
LNG Gae ee aegeecu unten Ruste omen y sani 8 1-256 
Starting ‘collumn <2 3 a 11 1-255 
OVerlaysdatas (ei tic cece: sas es Name: Date: 
F3=Exit F12=Cancel 
4 
Figure 21. Change Report Overlay Line 
Type your changes over the existing lines. Press Enter to move to 
age 14 
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a 
Work with Report Overlays ONDMD400 


1/31/98 15:33:35 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Overlay Action Line Overlay data 
ABC EL 001 
STMT cD 008 Name: Date: 


Bottom 
F3=Exit F5=Refresh F12=Return 


Report overlay line changed. 


Figure 22. Work with Report Overlays 


The message at the bottom of this screen confirms your changes. 


To Delete a Report Overlay Line 
Use [Figure 23] to delete an existing report overlay line. 


Vee 
Work with Report Overlays ONDMD400 


1/31/98 15:33:12 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Overlay Action Line Overlay data 
ABC IL 01 
4 STMT cD 008 Name: Date: 


Bottom 


F3=Exit F5=Refresh F12=Return 


Figure 23. Work with Report Overlays 


Press Enter to move to|Figure 24 on page 17 
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Confirm Delete of Report Overlay Line ONDMD400 

1/31/98 15:34:53 
Press Enter to confirm your choice for 4=Delete. 
Press Fl2=Cancel to return to change your choice. 


Overlay <4 2 ssw we we 6 a a STMT 
ACEIONG Lee col eecees tena cocsces ee CD IL=Insert line 
CD=Change data 
TING: Ge aes ae SR eel eee a 8 
Starting columns sis 4 ve ee at 11 
Overlay-datay wi 29) 4 24, 2.03 iNomes Date: 
F12=Cancel 


Figure 24. Confirm Delete of Report Overlay Line 


If the information_you entered is correct, press Enter to delete the report overlay 
line and move to 


If the information is not correct, press F12 to change your entry. 


# 
Work with Report Overlays ONDMD400 
1/31/98 15:35:04 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Overlay Action Line Overlay data 
ABC IL 001 
STMT cD 008 Name: Date: 


Bottom 


F3=Exit F5=Refresh F12=Return 
Report overlay line deleted. 


Figure 25. Work with Report Overlays 


This screen confirms that the report overlay line you selected was deleted. 


To Display a Report Overlay Line 


Use |Figure 26 on page 18] to display an existing report overlay line. 
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fa 
Work with Report Overlays 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


ONDMD400 
1/31/98 15:33:12 


Opt Overlay Action Line Overlay data 
ABC IL 001 
5 STMT cD 008 Name: Date: 
Bottom 

F3=Exit F5=Refresh  F12=Return 
Figure 26. Work with Report Overlays 
Press Enter to move to 
a ; ’ 

Display Report Overlay Line ONDMD400 


1/31/98 15:33:46 


OVENRT ays soey eo tence eeae st eecave Ker cee OMIT 
ACEION <4. Sow, oe ee is He CD IL=Insert line 
CD=Change data 
PANG) wee een eanet zp sew ee eee eit eee 8 
Starting column: <i a) ew kt 11 
Overlayxdata: %. . 4 Ack ee ee Nome: Date: 
Bottom 


Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 27. Display Report Overlay Line 


This screen lets you view the overlay line you selected. 


Option 4. Work with Report Definitions 


18 


IBM Content Manager OnDemand for iSeries: Administration Guide 


Every report stored in OnDemand needs a definition. The definition contains 
information about the location of the segmentation control characters, the report 
date, the keys (indexes), and the display fields. It includes the policy name 
OnDemand uses when it migrates the report to optical media or tape. 


Note: It is common to use this option in conjunction with other options that are 
described in{ Option 20. Reporé Definition Menu” on page 71} but IBM 
includes it here for your convenience. IBM recommends that you use the 
OnDemand Report Definition Menu or iSeries Navigator to work with 
report definitions. 

Before you create a report definition, decide which keys you want to use for later 

retrieval of the report segments. Find these keys within the spooled file by using 

either absolute or pivot processing. Use absolute processing when the information 
within the spooled file is consistently located in the same column and on the same 
line for each report segment. If the information is always in the same column, but 
the line number is not consistent, pivot processing lets you define a string from 
which to calculate the line location of the information to be extracted. 


There are five types of reports you can define to OnDemand. (All of the examples 
in this book use DOC reports; the other types are shown in detail in|"Examples of 
[Report Types” on page 10d) 
Document Reports (DOC) 
These reports are composed of many stand-alone items, such as invoices or 
statements. Each item (known to OnDemand as a segment) can be 
separately indexed and retrieved. Commonly used indexes are: Customer 


number, store ID, social security number. 


The CHECKSTMTS and TSTINV reports stored during the installation 
verification test are both DOC reports. Their report definitions are included 


with your OnDemand software; you can view them from|}“Option 4. Work 
ith Report Definitions” on page 18 


Page Reports (PAGE) 
These reports have no unique keys, but they can be logically indexed by a 
range of values. Reports are segmented (up to 100 pages per segment) and 
are indexed by the starting and ending values of each segment. You can 
always locate a segment by page number. 


For example, OnDemand can divide a general ledger report of 1 000 pages, 
sorted in ascending order by account number, into 10 100-page segments. It 
monitors the first account number at the top of the first page and the last 
account number at the bottom of the last page of each 100-page segment. 
When you request any account number on the report, OnDemand searches 
the range of each segment, and finds that account number. 


The TSTSEQ report that was stored during the installation verification test 


is a PAGE report. Its report definition is included with your OnDemand 
No-Index Reports (NODX) 
These reports have neither a unique key nor a logical range value index. 
The key 1 index is always the segment number (first x pages, second x 
pages, and so on, where x is the number of pages you have defined as the 
segment size). The key 2 index is always the report date (in MM/DD/YY 
format regardless of the date format and date separators specified for the 
job). The key 3 index is always the page number used to locate a segment. 


Unbundled Reports (UBND) 
Use this definition when the spooled file contains several different reports 
within the same file. OnDemand automatically unbundles (splits) the 
spooled file into separate reports, if there is a matching report definition in 
the report definition table. Define a UBND report with unbundling 


Chapter 1. Using the OnDemand Spool File Archive Feature 19 


(segmentation) characteristics, so the report capture program can detect 
when a new report begins and ends within the spooled file. 


To unbundle, always place the report name for each new report in the 
same position on the page of each report. 


AnyStore Reports (ANYS) 
An AnyStore report (ANYS) is a special report type that is used only with 
the AnyStore APIs. AnyStore reports contain pieces of data that are stored 
and indexed using the AnyStore APIs. Examples of an AnyStore report are 
file members, an entire spooled file, an Integrated File System object, or a 
stream of data in a program buffer. AnyStore reports always belong to a 
report group. 


To begin, select option 4, Work with Report Definitions, from the Report 
ADMINISTRATION MENu, (see |Figure 3 on page 4} or use iSeries Navigator for a 
graphical user interface to this function. If you choose to use the non-graphical 


interface, displays. 


r ~ 


Work with Admin for OnDemand (WRKADMRDAR) 
Type choices, press Enter. 
Administrator function..... >*REPORT *REPORT, *RPTGRP, *RPTOVL... 
Report, nam@yas ee. setie! ce. ace: tess *All Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 28. Work with Admin for OnDemand (WRKADMRDAR) 


Press Enter to continue. 


To Create a Report Definition 
Use through to create a report definition. 
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a " 


Work with Report Definitions ONDMD400 
1/08/98 14:49:34 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Report Version Type Text 
i BILLS 01 
AGEDOC 01 DOC Age Open DOC 
AGEOPN 01 PAGE Aged open receivable report 
AIC250 01 PAGE Warehouse report 
ANNOUNCE 01 NODX Announcement list 
APCHK 01 DOC A/P checks 
AP437 01 PAGE A/P account listing 
BEL3549 01 DOC Bank edit 
BRMS50 01 DOC Tape processing rpt 
BUDGET 01 DOC Budget report 
CHECKSTMTS 01 DOC Check Statements (OnDemand Example) 
GLDAILY 01 PAGE G/L Daily by account 
GLTRANS 01 PAGE G/L Transaction report 
More... 
F3=Exit F5=Refresh  F12=Cancel 
MS / 


Figure 29. Work with Report Definitions (Create) 


Press Enter to continue to 


Sample Worksheet 


You can use the examples in|“Report Definition - Environment Work Sheet” on page 99]and 


complete them manually before you enter data on this screen. Some fields appear on the 
screen only under certain conditions. 


( Create Report Definition - Environment ONDMD400 ) 
1/08/98 14:49:43 
Type choices, press Enter. 
REPO Ca cme Rana ee cem some etc alsin rat un caNr ans BILLS ame 
VeRSdlOMhmesaeseene sarsserares oY ae, Fate acs eee tucueemesan et Ze 01 01-99 
REPOMG: TYPG= sce se Ae ie Ae fos vet co? cot van car pene deseies ve DOC DOC, PAGE 
ODX, UBND 
Input: record’ length <3 ss © a: @ = “cc vA 133 20-256 
PON GW MAME geeees. oo eee fort ey es vearapese ses emacs ce D9OOPTICAL ame 
Reportroverlay arctan eis tn asses east sone wuae eres ame 
Reportdata types. 5-3 Se wi eS eR *OTHER *SCS, *AFPDS 
*OTHER... 
REDOMGsg OUP: yale voesehe mon cel daremhe el te tem cn ears eee ame 
Translates print control. sss <i eoce Sone el &, ce N Y=Yes, N=No 
Pretinbere whillies ty csp sens, cao se tater cw emrelies comin ve ame 
EDA Vaan tea eo vcencas cue cme ctr cee a atone Aas 
TAG cee source scimy crate Panes herman etcs ouacy crn at: Ronn Billing statements 
GOMPRESSTONG vey cos Gh asy et tates su tue ace saree leu cel een os if Y=Yes, N=No 
Postingindatestype ec. s. ih G. ccus cours, Yon’e sso voce 1 
More... 
F3=Exit F12=Cancel 


Figure 30. Create Report Definition - Environment (1 of 3) 


Before you create the definition, be sure the report policy is entered in 
ork with Report Policies” on page 5 
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Press Page Down to continue to|Figure 31] or|Figure 32} depending on your entry 


for Posting date type. 


A 
Create Report Definition - Environment ONDMD400 a 
1/08/98 14:50:49 
Type choices, press Enter. 
Posting date: 
IL YD Cetanew cares eects conser aetctet eee nee wee sehen 1 
EGMGEMIN: tres, nce alcan sd, etree cna key ens mie ah 8 0-25 
Cod umn: <. 20s Se ae ie Ge ee, 120 0-255 
ai eere is eraee face Guba eran ride ee etn ran ee ays tee 2 0-256 
-OR- 
PiVOt Value! sts) 6G et ce ee sp ce ce Ss 
Eengt Miata atscncmtsusmrahtensu esterase ts erence 0 1-16 
COsumnicaterpee caecameneer cco beo ences wotueee Pou saa vedio 0 0-255 
tar VIN@ORTSCR «se Ge ee ee es ee eos 0 -255-256 
More... 
F3=Exit F12=Cancel 
4 
Figure 31. Create Report Definition - Environment (2 of 3) 
Press Page Down to continue to|Figure 32 
Create Report Definition - Environment ONDMD400 
1/08/98 14:51:26 
Type choices, press Enter. 
Bypass report results display ........ N Y=Yes, N=No 
Bypass document results display ....... N Y=Yes, N=No 
Search all sequence numbers ......... ¥ Y=Yes, N=No 
DM PUES ON TGEE reece esc csy an ereteniemecmnsa ees sae coker es Name 
ETD Ranryeemmstoe contenant cet tececcueca: saneme mrs eiean *LIBL 
Index tex1 tis. 55 oo: eee: cen See ce, eee ers ee eee ee Name 
[Le floy gf Wha ie semeenrsen ufo kc patrne crt. creer rac esa ata eer e *LIBL 
Wnbundihevexdt corse aicucct cscs te wetec este roun terme se Name 
IED ARV Fe. aetoes eve oe) cee seks tereos es Wer ois, ee oes *LIBL 
Use AFP Imbedded Indexes ........... N Y=Yes, N=No 
Bottom 
F3=Exit F12=Cancel 
ey 


Figure 32. Create Report Definition - Environment (3 of 3) 


Use AFP Embedded Indexes 
Only valid for report data type of *AFPDS. Enter either: 


* N to use normal OnDemand indexing. This requires that you define all 
the indexing information to OnDemand in the report definition. 
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* Y¥ to use embedded AFP indexing and grouping tags. OnDemand 
extracts these tags from the input data and uses them. You must still 
define the key names and lengths for these keys to work properly. 


Note: If you set this flag to Y, then OnDemand will use this indexing 
method for the entire report. (The system does this instead of 
defining lines and columns or pivot values for segmentation, key, 
and so forth). In other words, you cannot mix embedded 
segmentation and indexes with explicitly-defined segmentation and 
indexes within one report definition. If you use embedded AFP 
indexes, frame each segment with a STRPAGGRP and 
ENDPAGGRP. Place the DOCIDXTAGs (to identify the key values) 
for the segment between the STRPAGGRP and ENDPAGGRP and 
specify GROUP as a level. (OnDemand does not process PAGE 
indexes.) You can use the IBM product ACIF to create these groups 
and indexes on other IBM systems. 


Press Enter to save your entries and to move to to continue creating your 
report definition. 


Use the screen in [Figure 33] to define the segments you want from the spooled file 
of this report. The spooled file usually contains multiple documents or sections of 
the report (such as invoices or departmental sections). Segmentation tells 
OnDemand how to find the end of one section and the start of the next within the 
spooled file. 


Sample Worksheet 


You can use the example in|“Report Definition - Segmentation Work Sheet” on page 101 


and complete it manually before you enter data on this screen. Some fields appear on the 
screen only under certain conditions. 


é 
Create Report Definition - Segmentation ONDMD400 +) 


1/08/98 14:51:39 
Report/Version so. 4465 <<4 4 ‘ SBILES / 01 


Type choices, press Enter. 


SQGMENE <SIZer S06 Gece een le sn eee 100 1-100 
Segmentation condition 1: 
CGhange/Match) = 4.0%. ce 3 we Sa eS 1 1=Change, 2=Match 
Vail Guaerstueceastetnicracmcrn ciayirsmecmect eats 
Length: i: <0 s- & eick ae ce er ewe ee cs 8 0-25 
(SoM NM eoaeee hoe sree ieee ech ce ere a 5 0-255 
STH =wameer seers er ty aeeecCuecenoy Ps ree co he ar 4 0-256 
-OR- 
Pav Oi AWVialiU Clee tees tracey enewned sre ae 
|E=i s)he] (hoeecrceh ee igo ae a eee 0 0-16 
GOUMM Se, Sook senor ces nee cet eter sre 0 0-255 
t= line ORS: st toi ea. gt eS 0 -255-256 
Condition ‘combination = < «2: 4%. ss 0 O=None, 1=And, 2=0r 


More... 


F3=Exit  F12=Cancel 


———————————————=_E=L=-_ 


Figure 33. Create Report Definition - Segmentation 
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The heading entitled Segmentation condition 1 may appear as Start of report condition 
1 for PAGE and NODxX< report definitions. 


Press Enter to continue to|Figure 34 on page 25 


Sample Worksheet 


You can use the examples in |Report Definition - Keys Work Sheets” on page 102] and 


complete them manually before you enter data on this screen. Some fields appear on the 
screen only under certain conditions. 


Use |Figure 34 on page 25/through|Figure 38 on page 27|to define the keys for 


storing and retrieving segments of a report. You can combine letters and numbers 
in your definition of: 

* Key 1 - maximum of 25 characters 

* Keys 2, 3, 4- maximum of 20 characters 

* Key 5 - maximum of 15 characters 


You can use these keys alone or in any combination. 


If your report has a hierarchy of indexes—for example, store numbers within a city 
within a region—you might define your keys as stated below: 


* Key 1 = region code 
* Key 2 = city code 
* Key 3 = store number 


This lets you display all reports for a store number in a city in a region, and 
reduces the number of items that meet the search value. 


You can also use partial keys, which describe a part of the entire key. For example, 
you can use a partial key to find all bills for account numbers that begin with 111. 
You do this by entering 111* for the search key. If you use a complete 
key—111-2278—you can limit your search to that particular account number. (Due 
to the unique nature of the key structure, partial keys are not supported for PAGE 
reports.) 


Also important are the field lengths you define for the keys and display fields. On 

the Work witH Documents screen, the width of the columns is determined by the 

greater of either: 

1. The Length (size) of the key or display field as defined in the Report 
Definition, OR 

2. The number of characters (size) of the Key or Display Field Name as defined in 
the Report Definition. 


If you define such wide fields and field names that they do not all fit on the 
screen, OnDemand will display an additional function key (F11l=Change View) at 
the bottom of the screen to allow you to toggle so that you can see all the data. 


If you set the Minimum search characters field to 0 within a particular key definition 


(keys 2 through 5), it becomes a display field. It appears on the Work wirH 
Documents selection list, but end users cannot search by this field. 
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a Create Report Definition - Keys ONDMD400 
1/08/98 14:52:24 
Report/Version) so. 1 & wwe ee, eee BILLS / 01 
Type choices, press Enter. 
Ke yar inameien ts: cemcsstcobsu cr rst mesesimteomermert or ek sears Name 
Bengtlis cits. non cares votes os Yemecn sea euuee Pouedass Seatse 25 1-25 
Minimum search characters ......... 3 1-length 
Location: 
CO! UNMe tosre steaks dope mcten ten Reaesneea pean salve cays 5, 0-255 
IN GMEetrae ee newb nce pice thet acme sh esa acst ehh oes 6 0-256 
-OR- 
Bait ValiUer css esc ten on nee euier Moo cunts cease 
E@nG thie redtatr teeta teutesom haces peers 0 0-16 
GOlUMMarerrseetcrscmcr cet srccbecneet eas cc tee 0 0-255 
hs VNG@SORTSEE: se. 5. aioe eS ae ce ve 0 -255-256 
Eoweracase: Key > touts 4 verdes: cen et ce sl gsm ¥; Y=Yes, N=No 
Key Security <. 4 -c ¢ «0 ee we N Y=Yes, N=No 
MUI IKe vite rterccs muveccen wsorewnemon cu rcrace weunenss N Y=Yes, N=No 
More... 


F3=Exit F12=Cancel 


Figure 34. Create Report Definition - Keys (1 of 5) 


Some fields might not appear on the screen for certain report types. 


The following screens allow you to enter your requirements for Keys 2 through 5, 


using the instructions for Key 1. Press Page Down after each key definition until 


the last key definition is completed. (Key 2, 3, and 4 allow a maximum of 20 
characters each; Key 5 allows a maximum of 15 characters.) 


Press Page Down to continue to 


é 
Create Report Definition - Keys ONDMD400 be 
1/08/98 14:53:00 
Report/Version wien a i a kee ese SBTLLS / 01 
Type choices, press Enter. 
Key 2 names. Ge vey: pace cs. sirsticery owe rerete: See ses Account No._ 
Eenigithiecwcorsecuetecal stew tsntoe mine op Cen cane 8 1-20, O=Not used 
Minimum search characters ......... 4 0-length 
Location: 
CON MMM Etat tees east rss teen tes Gree 5 0-255 
E Ila\seouey eanais Oe en ark ereoee ee sho pe ae he ree mca 4 0-256 
-OR- 
PaAVOESVaillUGt kt co.cc rssteras ea caaty en en cee 
[ee Vale hel (encase cite aoneechuercaatrue Pa seep emer ir ats 0 0-16 
COs ME ere akome cae tects eee ee eee 0 0-255 
to ViiNe:-OTSCt: vel s. evs aucea se ee Cranes 0 -255-256 
ROWER EG aS OU KeVe as ies vey soe ceoessntes corms seenee es N Y=Yes, N=No 
KEYSCGURIGYs <n tue) cco casera one cause foe es yetnee ce N Y=Yes, N=No 
Muti =key Ss gos wie We ee ee oe, N Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 
re 
Figure 35. Create Report Definition - Keys (2 of 5) 
Press Page Down to continue to|Figure 36 on page 26 
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Create Report Definition - Keys ONDMD400 
1/08/98 14:53:28 
Report/ Version: «02 sce eres atu a ee Se BELLS / 01 
Type choices, press Enter. 
Key SoINaMOC se pesn ceerse co foo he eo enter etoenauece cst 
eins fel nernconerr ern eer: ee eect ae nercn es eer ceee 0 1-20, O=Not used 
Minimum search characters ......... 1 0-length 
Location: 
Coun beeen usd et op teute se duns epae te Semed 0 0-255 
WEIN Sie Rad teee cress rt sesh oe oe raccul beste cuneee ees 0 0-256 
-OR- 
PAVOG Va UC se, crs cee tte soso Gaara) cer oe fens 
E@nGtNintccparcueste teach oie re oun ametuer 0 0-16 
CONUMME ae aecss ey works toecouse tie tccm sss Velas 0 0-255 
t= Tine offset = «sa 6 eG a % e 0 -255-256 
Lowercase key tirvs tyicsus: cece au tow wcacesy se, os N Y=Yes, N=No 
Key Security 9.5 5) ewe a ee ee N Y=Yes, N=No 
MUN EN EIKOV. A Steen Gp oue seis emcencalodeorcnmrre a eas N Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 


Figure 36. Create Report Definition - Keys (3 of 5) 


Press Page Down to continue to 
Complete the fields, following the instructions for |Figure 34 on page 25 


( Create Report Definition - Keys ONDMD400 
1/08/98 14:53:42 
ReportyVersion: sess 2) ee site eens BILLS / 01 
Type choices, press Enter. 
Key 24 Mamet 2fs8 vos beseactys: rot colnts aren tem conte vaterss Yarns Amount 
Length: fs, ef ean ee oe ee ie ae 8 1-20, O=Not used 
Minimum search characters ......... 0 0-length 
Location: 
Codumni cn so ese ee eS Re ee ee 126 0-255 
IN CAMeny eens. eco ncmeCpcr oe tot ae tL orecme mnt. 0 0-256 
-OR- 
Biv OteviadUer scot -sareie <ogecleters vou csse ease te Total 
eng ths s2osnex sce vet wa cmcauscte loses. uel ts 6 0-16 
COMUMN oleae vce ess sene seo temttatemeetres veuve 120 0-255 
r= NMNETORESCEe tease eye qe lees oudeme rosaries 0 -255-256 
lower case. key, 222. Sx ie ee ee a N Y=Yes, N=No 
Key ESCCUTIGY 2 cc arcgs Wathen Guns ne tberer ero cae eateuere N Y=Yes, N=No 
MUSIEK yors. te en cengee seers ot: nena ceetes ea rey eens N Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 


Figure 37. Create Report Definition - Keys (4 of 5) 


Press Page Down to continue to|Figure 38 on page 27 
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Create Report Definition - Keys ONDMD400 
1/08/98 14:54:31 
Report/Version) so. 1 % VMs eee wees, BILLS / 01 
Type choices, press Enter. 
Ky co MAMG' fo. er ce orbs ap fou sh Mec csces cers ose ieee 
Wengitliaeaerouccar ayetece tc avcme arcone ncn rcan saeco 0 1-15, O=Not used 
Minimum search characters ......... i 0-length 
Location: 
COL UNMME tesreatauts dope mcten ten teases pean salye cals 0 0-255 
DIN GMEeteae ce neh tecs pice thet ica sh era acst ehh ees 0 0-256 
-OR- 
PANO SV aUCh cose sea ten on see eouiee Moo sane cease 
Keng thiercdtater teeta teuesem chases pees 0 0-16 
(Gio} HVT aeenevcmes primeira sraecn ry ecusr mace rar 0 0-255 
t= VN OfTSEE: 5. aioe eS ee ve 0 -255-256 
Eowercasekey> sous) & vests oe ee se ae N Y=Yes, N=No 
Key security <. 4 #-c. ¢ «0 ewes we N Y=Yes, N=No 
MUNETSKOYs erate ces eaten cee teu nesin top suas as hie N Y=Yes, N=No 
Bottom 
F3=Exit F12=Cancel 


Figure 38. Create Report Definition - Keys (5 of 5) 


When you are finished, press Enter to complete your report definition. 


appears. 
( : rane ms 
Work with Report Definitions ONDMD400 
1/08/98 14:54:35 
Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 
Opt Report Version Type Text 
AGEDOC 01 DOC Age Open DOC 
AGEOPN 01 PAGE Aged open receivable report 
AIC250 01 PAGE Warehouse report 
ANNOUNCE 01 NODX Announcement list 
APCHK 01 DOC A/P checks 
AP437 01 PAGE A/P account listing 
BEL3549 01 DOC Bank edit 
BRMS50 01 DOC Tape processing rpt 
BUDGET 01 DOC Budget report 
CHECKSTMTS 01 DOC Check Statements (OnDemand Example) 
GLDAILY 01 PAGE G/L Daily by account 
GLTRANS 01 PAGE G/L Transaction report 
More... 
F3=Exit F5=Refresh  F12=Cancel 
Report definition created, F5 for Refresh. 
4 
Figure 39. Create Report Definition - Keys (Confirmation Screen) 
This screen confirms the addition of your report definition to OnDemand. Press 
Enter to return to the Report ADMINISTRATION MENu, 
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To Change a Report Definition 


If you want to change a report definition—its keys, for example—select option 4, 
Work with Report Definitions from the Report ADMINISTRATION MENu. (See 
Figure 0] 


lon page 41) [Figure 40]is then displayed. 


fo 
Work with Report Definitions ONDMD400 
1/08/98 14:55:24 
Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 
Opt Report Version Type Text 
AGEDOC 01 DOC Age Open DOC 
AGEOPN 01 PAGE Aged open receivable report 
AIC250 01 PAGE Warehouse report 
ANNNOUNCE 01 NODX Announcement list 
APCHK 01 DOC = A/P checks 
AP437 01 PAGE A/P account listing 
BEL3549 01 DOC Bank edit 
2 BILLS 01 DOC Billing statements 
BRMS50 01 DOC Tape processing rpt 
BUDGET 01 DOC Budget report 
CHECKSTMTS 01 DOC Check Statements (OnDemand Example) 
GLDAILY 01 PAGE G/L Daily by account 
More... 
F3=Exit F5=Refresh  F12=Cancel 
NG 4 
Figure 40. Work with Report Definitions (Change) 
Press Enter to continue to|Figure 41 
( : 
Select Report Section to Change ONDMD400 


1/08/98 14:55:39 


Type selection, press Enter. 
1=Select 


Choose Section 
Environment 
Segmentation 
Keys 

I All sections 


F3=Exit F12=Cancel 


Figure 41. Select Report Section to Change 


You can go directly to one of these fields of a report definition. Type 1 next to the 
appropriate field: 
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Environment 
To change only the environment of the report definition. 


Press Enter to move to|Figure 42} Report DEFINITION - ENVIRONMENT. 


Segmentation 
To change only the segmentation of the report definition. 


Press Enter to move to|Figure 45 on page 31) Report DEFINITION - 


SEGMENTATION. 


Keys To change only the keys in the report definition. 
Press Enter to move to|Figure 47 on page 32) Report DEFINITION - Keys. 


You can change the attributes of the entire report definition: 


All sections 
Enter 1 to display all change screens in sequence. 


Press Enter to move to [Figure 42 


( Change Report Definition - Environment ONDMD400 +) 
1/08/98 14:55:51 
Report/Versionvs, 4s, we ee ee ee, BLLIES / 01 
Type choices, press Enter. 
REPORESEYDGs se peisa kee: co: doy fat ces Geurcatt care fon te en ties 6 DOC DOC, PAGE 
ODX, UBND 
Input: record: length <3: 2 34 44 5 #6 3 2 133 20-256 
Polaieyvname’ Gia sc hse) aco use ssl tcsucaust sateen ue wens D9OOPTICAL ame 
Reportsoverllayicsesicas te coven te eset key Mes Se neg an ee ame 
Report data ‘typecs 3. <5 6 so 5 we ce we wine eh eS *OTHER *SCS, *AFPDS 
*OTHER... 
REPORESGROUP toc: aero chose ete ce heste ree ie) ve theese ce ame 
Translate sprinticontrol, 4, 6 2:2 Seca cesses ie ee Ue N Y=Yes, N=No 
PAu ane =1 Ooty pill =a oe ener arti orn MEM ara iy aie Morar ame 
IDA Via ance rensure cum anears cata wcu Urine: Semana 7s 
UR Cae orteru tee tiirie nh koran eta ed ers PAA aE Somer Geer Billing statements 
COMPRESSTOM Se. Re see. ce 0k ss reset cee Gee eed en wh te Y Y=Yes, N=No 
Posting:sdatestypes 25% 2 bcs eo ey se wt ene er cat it 
More... 
F3=Exit F12=Cancel 


Figure 42. Change Report Definition - Environment (1 of 3) 


Type over any field information to change it, and press Page Down to continue to 
Figure 43 on_page 30|if you have entered a value in the Posting date type field; or to 


continue to|Figure 44 on page 30|if you left Posting date type blank. 
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a 


Change Report Definition - Environment 
1/08/98 
Report/ Versa ss «i oe a ee we ee ee ee BIELES / 01 
Type choices, press Enter. 
Posting date: 
TV Ozecomecan cera eens cm ste eurcremeenearsnicatesns. cruncans 1 
hengthic. 4° fee: % ie Ge ee ep es es 8 0-25 
Colummigenenstpucmasiecate rere seiyat caesarean Rees 120 0-255 
LETIMG Soc ace ret sea roas te cotes Bien te tsayenees Pouese. oh ceane 2 0-256 
-OR- 
Pa VOGoMal Wei ois cttaici coc ve) fe) ca cel sue gece us news 
Bengt hive sess sce setae tee ou cea esanes rose crs teas 0 1-16 
Coullimmitee se acoksdeescphsrees ea eenemen scoot eres 0 0-255 
Ta wMNELORTSCL wie oss vended soeene eee) seus ees @ -255-256 
F3=Exit F12=Cancel 


ONDMD400 
14:56:01 


More... 


Figure 43. Change Report Definition - Environment (2 of 3) 


cat over any field information to change it, and press Page Down to continue to 


Figure 44 
fe me ; * 
Change Report Definition - Environment ONDMD400 
1/08/98 14:56:05 
ReportyNersiOnis.ec. ce sp ciyes semten e egtee  ee OBES / 01 
Type choices, press Enter. 
Bypass report results display ........ N Y=Yes, N=No 
Bypass document results display ....... N Y=Yes, N=No 
Search all sequence numbers ......... Y Y=Yes, N=No 
TM PUL OAL Retest ke tess votes ee ueyriseromiea sees as aeeuctes Name 
ETD RanVeonces ue couse alciec asi ieoeer esate ieremac a epee *LIBL 
Tndexc@xT ti noice eo ae 5, eee Ge Wade ee ce ets av ee Name 
[Lrfloy of Wht auerurc serie ih gs Maire ease et het rae rae ee Pe *LIBL 
Unibundiliesexdt. cee eis 21 ac ces Poke em eusiate. soca oe Name 
END ARYA Gece oetive, ee Seas) irecuer outer Nevers, vteee 16 *LIBL 
Bottom 
F3=Exit F12=Cancel 
zy, 


Figure 44. Change Report Definition - Environment (3 of 3) 


ia over any field information to change it. Press Enter to continue to 
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Change Report Definition - Segmentation ONDMD400 
1/08/98 14:56:09 
Report/Version) a <ci« @ 4 Nears = SB ULES, / 01 
Type choices, press Enter. 
SEGMENE,STZE° cee e> ay yen ces et a es way Ges 100 1-100 
Segmentation condition 1: 
Ghange/Matchy < ilarts Sou: we es 1 1=Change, 2=Match 
Via MG) Aimnsorcat ct tateieseass iyenoseesh siete ae 
length eeco tase ctce uss Mice ten eae en oars 8 0-25 
(opi T i nmecacse cyber ceo meee het ere ae 5 0-255 
Sills rioptpnteon i OR thairsen wre ty at eos 4 0-256 
-OR- 
Pa Oi Vial NU Cixetecvowcsse-srasey te Onewten freee ace 
lkengthy cs ereteuciese ess vei ve osesn ee ears 0 0-16 
GOUMMs Seesoos: Sen ce. ces Wi nv cet dee tee crete 0 0-255 
He ViN@sORTSER: eos Gta ee Gy oss 0 -255-256 
Condition combination = « «446 4 -% 0 O=None, 1=And, 2=0r 
More... 
F3=Exit F12=Cancel 
wy 
Figure 45. Change Report Definition - Segmentation (1 of 2) 
Type over any field information to change it. (The heading entitled Segmentation 
condition 1 may appear as Start of report condition 1 for PAGE and NODX report 
definitions.) If you have a second segmentation requirement and have entered a 
value in the Condition combination field, you can press Page Down to continue to 
the second screen below. If you have entered 0 in the Condition combination field, 
press Enter to continue to|Figure 47 on page 32 
eC oer : = 
Change Report Definition - Segmentation ONDMD400 
1/08/98 14:56:09 
Report /Versioni <2 eves ee oe knee ake = “BILLS / Ol 
Type choices, press Enter. 
Segmentation condition 2: 
Ghange/Matchi i gcc vse, dh ey Se 1 1=Change, 2=Match 
Vii LUGS ea soomen ccs rep couec ase Coens wey cours 
erigithimecaccameavogtsme ss eee ketsh comes 8 0-25 
(Gols ccs suet se es vs ek Wee cenesomeos 5 0-255 
Ei ee ietcanete: stecep cm caten arses urs 4 0-256 
-OR- 
PaO Vial WGY section ce es voles vo sey cos co 
Whength: qs, se4; eee es es ese eee as 0 0-16 
CojlUIMMNipesonsat env occme tts eemncne, creas 0 0-255 
Pac INEsORESEL. i ap wy Cer oc aa sees oe 0 -255-256 
More... 
F3=Exit F12=Cancel 
z/ 


Figure 46. Change Report Definition - Segmentation (2 of 2) 


Type over any field information to change it. (The heading entitled Segmentation 
condition 1 may appear as Start of report_condition 1 for PAGE and NODX report 


definitions.) Press Enter to continue to|Figure 47 on page 32 
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{eo 
Change Report Definition - Keys 


Report/Version BILLS 


Type choices, press Enter. 


Key 1 name 

Length 

Minimum search characters ......... 3 

Location: 
Column 
[Ki @teecgsctecmcmny cies kee cac sl beee cir sone murs 
-OR- 


Da 


Length 
Column 


eoo 


Lower case key 
Key security 
MUN EN EIKOV. 0S tcmrtn poke sues emcencalcdeor came a eas N 


F3=Exit F12=Cancel 


ONDMD400 


1/08/98 14:56:19 


/ 01 


1-25 
1-length 


0-255 
0-256 


0-16 
0-255 
-255-256 


Y=Yes, N=No 

Y=Yes, N=No 

Y=Yes, N=No 
More... 


Figure 47. Change Report Definition - Keys (Key 1) 


at over any field information to change it. Press Page Down to continue to 


Figure 48 


i Change Report Definition - Keys ONDMD400 
1/08/98 14:56:22 
ReportyVerSiOns “case oe ce cp cnn sh ences feos BILLS / 01 
Type choices, press Enter. 
Key c2 MAME’, arses roe: eet se: <o- te) basi Fos tou cetera tse Ye Account No._ 
engine ryscsct-cht enc forsee nim om ete ys 8 1-20, Q=Not used 
Minimum search characters ......... 4 0-length 
Location: 
Corl Umm venes. cece oe tyec uae ueauconsiete la ceceaye st 5 0-255 
WMG 5 ose gies es ws ae es 4 0-256 
-OR- 
PAVOGs ValUCs cys skies sca nerbat es veut ree hey te 
length? 2.5. ee Ap ee ee ew es ee 0 0-16 
GOuNUIMM faery etree arcom er neat gees 0 0-255 
Fa MlMMEORRSCES sare ste ey Fac tensucet een heres 0 -255-256 
Lower case keys sie cocrt: fu eu venluca st ae lene N Y=Yes, N=No 
KeysSCCULTEY sca va cos seis cee ser Pat se nee) actos be N Y=Yes, N=No 
MUMETEIKOW G2 eese crore ca tens evens cetieupsre store N Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 


Figure 48. Change Report Definition - Keys (Key 2) 


Type over any field information to change it. Press Page Down to continue to 
Figure 49 on page 33 
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Change Report Definition - Keys ONDMD400 
1/08/98 14:56:26 
Report/Version) 34 ww Vw ee, aoe, BILLS / 01 
Type choices, press Enter. 
KeyoSMaMOe iar cevcz coped cp ssn es ene spaeece a ose ieee 
Wengitlieeroecarcayetece cavemen ann rcan uae ean 0 1-20, O0=Not used 
Minimum search characters ......... 1 0-length 
Location: 
CO! UNMe tesre teats vopike mcten ten teases pean salve case 0 0-255 
Erin (eaesereerern a aee erarieee heerer renee eyuireer ean 0 0-256 
-OR- 
Bait ValiUer css esc ten on nee euier Moo cunts cease 
E@nG thie redtatr teeta teutesrom haces eee 0 0-16 
GOlUMMarerrseetcrscmcr cet srcbecnert eas cc tee 0 0-255 
hs VNG@SORTSEE: se. 5. aioe eS ae ce ve 0 -255-256 
Eoweracase: Key> to uis0 4 vesde os: cen et ce el gene N Y=Yes, N=No 
Key Security <. 4 s- ¢ ne ee ce we N Y=Yes, N=No 
MUI Ke yitre reece muveccen wsorrewnemcn cu rcrace weunenss N Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 
y/ 
Figure 49. Change Report Definition - Keys (Key 3) 
Type over any field information to change it. Press Page Down to continue to 
i ee >) 
Change Report Definition - Keys ONDMD400 
1/08/98 14:56:28 
Report Version a. 2e pene terkene ease ee eae ee) BEES: / 01 
Type choices, press Enter. 
Key: ASnAME: Gen bert re= Ua cace avateusien tensa dentereh Goud, ee ee Amount 
engine ecuctcteuy ce care ttre caeeiecuas ee eran 8 1-20, 0=Not used 
Minimum search characters ......... 0 0-length 
Location: 
GOi UNI seroma ate tosecn ve ietec ede csi yeaa: 126 0-255 
PANG? ane eo eee ee en Ge hase eee we ue ie ev ee as 0 0-256 
-OR- 
PaWiosviarliUerpress as. ae ecs ey hemect eal weaeamescU tae Total 
length: os a. 3 Se 6s ce tee ee We Ee 6 0-16 
COMUMNSe ae tiene aetna ee epee 120 0-255 
Tae INEZORESEL, ei ae he eee sdun nos oes cet ss 0 -255-256 
owertcasetkey. ako ss c.iecus oA seasa ce) Gee oye N Y=Yes, N=No 
KEYS CCUPTTY 2) v0 ina: cen cos Canes sabe won eet rece” N Y=Yes, N=No 
MUI SIKe Verses araqcd canst uc memes Aco ereotise teres N Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 
/ 
Figure 50. Change Report Definition - Keys (Key 4) 
Type over any field information to change it. Press Page Down to continue to 
Figure 51 on page 34 
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Change Report Definition - Keys ONDMD400 
1/08/98 14:56:30 
Report/ Version: «02 acs ee resumes eee ce BELLS / 01 
Type choices, press Enter. 
Keys 5 names cee csr cee ee cor Ss ies 6° Wet cet Ses ten sues cso ce 
Rengitha Sr orcercneae say ecru ecommerce rsa ecard 0 1-15, Q=Not used 
Minimum search characters ......... iL 0-length 
Location: 
Gomme beeen usd et ep reute se duns efae te Seed 0 0-255 
WEIN Cc Rad tote cre rts esteem ce raccul abe eat ctsee ees 0 0-256 
-OR- 
PAVOIEE Via UGive osc ce tere (eucen eas meey nes es fetes 
E@nGtNintcrcpaeicueste tea cetera oun amet aeaers 0 0-16 
GOuUMMbresare a stacncey vous cmon tate tere caves 0 0-255 
t= line offset = w «sa 6 eG a «2 0 -255-256 
Lowercase keye vie cy crnc. cteces cou cue ase. ve N Y=Yes, N=No 
KeYSSeCUnTEY Sess, Se eis behets ee sees vi ne N Y=Yes, N=No 
MUN ENEIKOV. AS tcmrcn Op oue seis emceccalcdeorcnmrre a eas N Y=Yes, N=No 
Bottom 
F3=Exit F12=Cancel 


a =~ 


Figure 51. Change Report Definition - Keys (Key 5) 


Type over any field information to change it. Press Enter to continue to 


ea 
Select Report Section to Change ONDMD400 


1/08/98 14:56:34 


Type selection, press Enter. 
1=Select 


Choose Section 
Environment 
Segmentation 
Keys 
All sections 


F3=Exit F12=Cancel 
Report definition changed. 


_ 


Figure 52. Select Report Section to Change 


This screen confirms your changes. 


Press Enter to return to the Report ADMINISTRATION MENu,|Figure 3 on page 4 


To Copy a Report Definition 


You can copy an existing report definition and assign the copy a new name, 
version number, or both. 
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For example, the screens show you a report definition, BILLS, version 01. We 
copied the report definition, kept the same name, and assigned a new version 


number. 


To do this, select option 4, Work with Report Definitions, from the Report 
ADMINISTRATION MENU, (see |Figure 3 on page 4). The screen, Work wiTH ADMIN FOR 
OnDemanp (WRKADMRDAR), |Figure 28 on page 20} appears. Complete it, and 


press Enter to move to 


a 
Work with Report Definitions ONDMD400 


1/08/98 14:56:56 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Report Version Type Text 
AGEDOC 01 DOC Age Open DOC 
AGEOPN 01 PAGE Aged open receivable report 
AIC250 01 PAGE Warehouse report 
ANNNOUNCE 01 NODX Announcement list 
APCHK 01 DOC A/P checks 
AP437 01 PAGE A/P account listing 
BEL3549 01 DOC Bank edit 
3 BILLS 01 DOC Billing statements 
BRMS50 01 DOC Tape processing rpt 
BUDGET 01 DOC Budget report 
CHECKSTMTS 01 DOC Check Statements (OnDemand Example) 
GLDAILY 01 PAGE G/L Daily by account 


More... 


F3=Exit F5=Refresh F12=Cancel 


Figure 53. Work with Report Definitions (Copy) 


Press Enter to continue to|Figure 54 on page 36 
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Copy Report Definition ONDMD400 
1/08/98 14:57:24 


To rename copied report, type New report, press Enter. 


Report Version New report New version 
BILLS 01 BILLS 02 


F3=Exit F12=Cancel 
NS J 


Figure 54. Copy Report Definition 


Press Enter to move to 


ra 
Work with Report Definitions ONDMD400 > 


1/08/98 14:56:56 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Report Version Type Text 


AGEDOC 0 DOC Age Open DOC 

AGEOPN 01 PAGE Aged open receivable report 
AIC250 01 PAGE Warehouse report 

ANNOUNCE 01 ODX Announcement list 

APCHK 01 DOC A/P checks 

AP437 01 PAGE A/P account listing 

BILLS 01 DOC Billing statements 

BILLS 02 DOC Billing statements (ver 2) 
BEL3549 01 DOC Bank edit 

BRMS50 01 DOC Tape processing rpt 

BUDGET 01 DOC Budget report 

CHECKSTMTS 01 DOC Check Statements (OnDemand Example) 
GLDAILY 01 PAGE G/L Daily by account 


More... 
F3=Exit F5=Refresh  F12=Cancel 
Report definition copied, F5 for Refresh. 


Figure 55. Work with OnDemand Reports 


When you press F5 to refresh the screen, the new, copied report definition appears. 


Press Enter to return to the Report ADMINISTRATION MENu,|Figure 3 on page 4 
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To Delete a Report Definition 


To delete a report definition, select option 4 from the Work witH Report DEFINITION 


screen. If there are no reports currently archived by this name, OnDemand deletes 


the definition. 


iemeceleppews, 


vA 
Work with Report Definitions ONDMD400 ) 
1/08/98 14:58:53 
Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 
Opt Report Version Type Text 
AGEDOC 01 DOC Age Open DOC 
AGEOPN 01 PAGE Aged open receivable report 
AIC250 01 PAGE Warehouse report 
ANNOUNCE 01 NODX Announcement list 
APCHK 01 DOC A/P checks 
AP437 01 PAGE A/P account listing 
BEL3549 01 DOC Bank edit 
4 BILLS 01 DOC Billing statements 
BRMS50 01 DOC Tape processing rpt 
BUDGET 01 DOC Budget report 
CHECKSTMTS 01 DOC Check Statements (OnDemand Example) 
GLDAILY 01 PAGE G/L Daily by account 
More... 
F3=Exit F5=Refresh  F12=Cancel 
y 
Figure 56. Work with Report Definitions (Delete) 
Press Enter to delete the definition. |Figure 57|is displayed for confirmation 
purposes. 
ie , toe > 
Confirm Delete of Report Definition ONDMD400 
1/08/98 14:59:09 
Press Enter to confirm your choice for 4=Delete. 
Press Fl2=Cancel to return to change your choice. 
Reports «.4- 4-6 43 et) ABILLS 
Version vice a ces a Sf FO 
Ty POiAs a cies ea a ener es DOE 
OX Ui eabed eceecos robes tesa Billing statements 
F12=Cancel 
& ey 
Figure 57. Confirm Delete of Report Definition 
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Press Enter to confirm deletion of the report definition. 


ie 


Work with Report Definitions 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Report Version Type Text 
AGEDOC 01 DOC Age Open DOC 
AGEOPN 01 PAGE Aged open receivable report 
AIC250 01 PAGE Warehouse report 
ANNOUNCE 01 NODX Announcement list 
APCHK 01 DOC = A/P checks 
AP437 01 PAGE A/P account listing 
BEL3549 01 DOC Bank edit 
BILLS 01 DOC Billing statements 
BRMS50 01 DOC Tape processing rpt 
BUDGET 01 DOC Budget report 
CHECKSTMTS 01 DOC Check Statements (OnDemand Example) 
GLDAILY 01 PAGE G/L Daily by account 


F3=Exit F5=Refresh  F12=Cancel 
Report definition deleted. 


1/08/98 


ONDMD400 
14:59:43 


More... 


Figure 58. Work with Report Definitions (Confirmation Screen) 


A message, see|Figure 58} appears to confirm deletion, and you can press F5 to 


view the remaining definitions. 


To Display a Report Definition 
Use [Figure 59] to begin viewing a report definition. 


ye 


Work with Report Definitions 
1/08/98 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Report Version Type Text 
AGEDOC 01 DOC Age Open DOC 
AGEOPN 01 PAGE Aged open receivable report 
AIC250 01 PAGE Warehouse report 
ANNNOUNCE 01 NODX Announcement list 
APCHK 01 DOC. = A/P checks 
AP437 01 PAGE A/P account listing 
BEL3549 01 DOC Bank edit 
5 BILLS 01 DOC Billing statements 
BRMS50 01 DOC Tape processing rpt 
BUDGET 01 DOC Budget report 
CHECKSTMTS 01 DOC Check Statements (OnDemand Example) 
GLDAILY 01 PAGE G/L Daily by account 


F3=Exit F5=Refresh  F12=Cancel 


ONDMD400 
14:57:41 


More... 


Figure 59. Work with Report Definitions (Display) 


Press Enter to continue to|Figure 60 on page 39 


IBM Content Manager OnDemand for iSeries: Administration Guide 


Display Report Definition - Environment ONDMD400 
1/08/98 14:58:24 
Report/VersiOntwec sales au ee ee ees IB ILLS / 01 
REPOMtety Per reskaeces cst rev tales on sarsmaeee coutomee esestrs: DOG 
Input: record length <<: Ss « www tow ow S133 
Polliieyename. 3 <2 se Sea ss ee ce we:  DOOORTACAL 
REPORtmOVeR ay. cscs) eo ce. ie: ge a tee) are Serato ts ane 
Report: data type: : <2. <5 6 & eee we Se es ~ & OTHER 
REPOnCRG OUD Per cmeate em cntme cons omc ismyomne Myenries 
Translates print iconmtvol” so acs eo feces x ets IN Y=Yes, N=No 
RGAE eR ew srs ese ksatceeeresn geaer kes csipcam eo mteyriomniee a 12 
tba Vn cee crn comes ce ihesateremnewtaictacusure lane tits 
TOXt es: on eusties ere Wee tel eo ee eae seer ee ten vey cer eee BINING eStatemenits: 
COMPRES STON sweat ten eWece aettoters ocareea eye nese te Y=Yes, N=No 
Posting date type ca. is feces Set et ee tes on ano 
More... 
Press Enter to continue. 
F3=Exit F12=Cancel 


Figure 60. Work with Report Definition - Environment (1 of 3) 


Press Page Down to continue to 


rc 
Display Report Definition - Environment ONDMD400 


1/08/98 14:58:30 
Report/Versiionisce- ee ce acters eecse sa Guerre) BILLUES / 01 
Posting date: 
TYP Oomea rcs somcg, eon cetceasy es) -o qeu tobias vou usmeen sores cet oats UL 
Bengt here tsa -saraw se sticer ca vce Pikes sian tametrey a wc on eer: 8 


Tisai neeiraney aoe Oita toate ie ain ture Cem Pere Ae 2 
-OR- 


Fengthicccciis waste hiecete. uke cw sue taen rowan ues 0 
(COMEV Ieee aoe Sos Pemxe Cee ee toe riaee Tomer Che 0 


More... 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 61. Work with Report Definition - Environment (2 of 3) 


Press Page Down to continue to|Figure 62 on page 40 
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Display Report Definition - Environment ONDMD400 
1/08/98 14:58:32 
Repont/VersiOn nw. sao ee Se Se ee ee | BILLS / Q1 


Bypass report results display ........: N Y=Yes, N=No 
Bypass document results display ....... se aiN Y=Yes, N=No 
Search all sequence numbers .........:2 v Y=Yes, N=No 
TAPUt LEXdibw ce siecs ce cate oy react ccmeu tes seuncn ron sous ees 

WIDVANY! St ese sek ear vie Mee ce enc era ae ees *LIBL 
TNGOX ROXAS rip cores eeu tetciee: cso eles soeene eae eRae ey 

illo gt WAN ite oer enna Grady sic eceeyy Nore pate ono hte ere tomer *LIBL 
Winbundiesexcitis 2. uveiie: veka so sso tiesncenst set Usracetese niece 

EID RAR Viens cpr cuecunt atc vacmcat me serct eae tie cman sane *LIBL 


Bottom 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 62. Work with Report Definition - Environment (3 of 3) 


Press Enter to continue to 


Ve 
Display Report Definition - Segmentation ONDMD400 *) 


1/08/98 14:58:35 


Report/ Version? nce eee aie BILLS / 01 


Segment Siz@. 2 we 5 ee ee ; 100 
Segmentation condition 1: 
Change/Matchy «4 s0.:45.. 4a. 3 2 VL 1=Change, 2=Match 
Vales ey ge ee ww oe, se sl ew : 
LengthatecntaG tein rs ae as ; 8 
(oH HUT] aeeaceeere cer oes ernie eee retonen yy irks 5 
[I MGgee wa teocey esa seenewce heen ents ae ene 4 
-OR- 


IEG Git hy se ewes) cetmeree ete ot cay ies neaes 0 
COM UMM mee tens enc ee eee ; 0 
Condition combination 2s 6 2 «a & & : 1 Q=None, 1=And, 2=0r 


More... 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 63. Display Report Definition - Segmentation (1 of 2) 


Press Enter or Page Down (depending on the entry for Condition combination) to 
continue i: eer (The headings on both segmentation screens 
entitled Segmentation condition will appear as Start of report condition for PAGE and 
NODxX report definitions.) 
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Display Report Definition - Segmentation ONDMD400 
1/08/98 14:58:35 
Report/Version a4 2% 5.64% * SBILES / 01 


Segmentation condition 2: 
Ghange/Match: 3.5. w2«. ¥ Nee a es eee 1=Change, 2=Match 
VENICE A rane a Pace arn caer ones 
Wengithseaute cet cacsaenae? come reocaren es : 4 
Col UMN) 22-28 Res ee ee | 72 
[Ei Tis\etoeecpens eerrrectn te oer nete reer krmerna ep aerate : 5 
-OR- 


Bengthip torcossa ta uwlacmes vey astom een sos 4 
GO) UMM are ep ake eee te ce. cso cnyenre 


ooo 


Bottom 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 64. Display Report Definition - Segmentation (2 of 2) 


Press Enter to continue to 


Ss 
Display Report Definition - Keys ONDMD400 4 


1/08/98 14:58:39 
Report Versione vtceg coe tet teons ee eee ce OB LELS / 01 


Key Lame. fs es ee Se ee ee | Name 
en Gth eee tceccs cet horee ete nor rc nc wee) Coe acer aces 25 
Minimumesearch:-chardcters, .) ss. 6. 43 a 3 
Location: 
Gomme enero aet et acetate rear ce eet oe cs 5 
[lies Aa en cemepe see’ Shiu ei rcts cue Matos Cau terscn earrezea ts 6 
ZOR= 


E@nGthnkssetr rae. eusu tue) romeceheducteto mr mre ase 
(GOlsUMMeme reeves rst to cal sorce eens acon cece sbien ce 


ooo 


TEQWERSCASELIKEY) (5. 3 suger -e: seis wes tates eco ee sec at Y=Yes, N=No 
KeyeSeCunitVe ls (sh calcitic esats a cl eeaawenss IN Y=Yes, N=No 
MUMETSIKOY <2 2 Sv euie se. ee Sees eden en Sete xeesee IN Y=Yes, N=No 

More... 
Press Enter to continue. 


F3=Exit  F12=Cancel 


Figure 65. Display Report Definition - Keys (Key 1) 


Press Enter if you are finished with your key definitions, or press Page Down to 
continue to|Figure 66 on page 42 
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(a 
Display Report Definition - Keys 


Repont/VersiiOn:: sare lees sss eee ee wo te BELLS 


Lengths i ce ie S04) i Se OS we ee eS : 8 
Minimum search characters .........: 4 
Location: 

GOIN? ie, 9er See se et el Pet xs aver tenon oe eee we 

Eile oeech ronson patente oa cet nor one eee rae er eo 4 

-OR- 


oa 


engthit eerce wercens cies netcouco ts ate lceeces es 
IGONUMMbe errr wena sie a vret cusses ean s cece ace: 


lowercase Key “sc wie 5 wp tel cer capes) ence we wate IN 
KeyrSOCUTTEY cr se peksamciye cen gouhetrenceues waa oices IN 
MUU SKEViR. protec cs pest ccpecmecwtmictacu caveat IN 
Press Enter to continue. 


F3=Exit F12=Cancel 


ONDMD400 
1/08/98 14:58:43 
/ 01 


Key 2iname@s sr se, oh oo or ae ce os) a Geese we ses ge | ACCOUNTING: 


Y=Yes, N=No 
Y=Yes, N=No 
Y=Yes, N=No 
More... 


Figure 66. Display Report Definition - Keys (Key 2) 


Press Enter if are are finished with your key definitions, or press Page Down to 


continue to 


ra 
Display Report Definition - Keys 


Report Version: wpe ces cv cr ea ee BILLS 


Key Siname so ks Se ee ee Ge cee ee 
Lengthiguvarcwcor tr upcy est ecu rrersaret ice year: 0 
Minimum search characters .........:2 1 
Location: 


oo 


MEQIIGEN ick Hes prays saben elmore gotllien Geaeoueese tn eo oe 
(ol IViMligereaterrheae ert sopra eit teeth eae e 


LowenccaSexkey.- sits A cer te se et ee cee, IN 
Key ‘SCCUnITY ai &. % Se eas ee we ce we SEIN 
MUG ASKe Votre uence sancucily cite soca eue te ucansueceiearseonuIN 
Press Enter to continue. 


F3=Exit F12=Cancel 


ONDMD400 
1/08/98 14:58:45 
/ 01 


Y=Yes, N=No 
Y=Yes, N=No 
Y=Yes, N=No 
More... 


_ 


Figure 67. Display Report Definition - Keys (Key 3) 


Press Enter if you are finished with your key definitions, or press Page Down to 
continue to|Figure 68 on page 43 
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Display Report Definition - Keys ONDMD400 
1/08/98 14:58:48 
Report/Version) a « 4% VN wee ee we ee BILLS / 01 


Keyc4 name: 2.93 Soe es es es ee ee ce | AMOUNT 
Ik@ngth sta os Be Kielce ee ee 8 
Minimum Search: characters’... 3. <0 ss 4.4? 0 
Location: 
COMUMNG se: as Se eget cee ces ee eter wee ep eee 126 
ESTs \ctste pornernnteen te rick th ory araere, Cio. oe aeay ee 0 
-OR- 


Benigthiy occu ta uwlacmess verse cee cnn cies cc ous eras 6 
(GoVAV Nas ereenseeen ears eceeyinn Cemeteries 120 


ower ‘GaSe Key: asc wee Wit eee ee ee IN Y=Yes, N=No 
Key SCUTEY] octet savour er so temeen eh Se oe cee IN Y=Yes, N=No 
MUublGIRSKeye cs or cass twicice caeredescemecumsone meee nyu AN Y=Yes, N=No 

More... 
Press Enter to continue. 


F3=Exit  F12=Cancel 


Figure 68. Display Report Definition - Keys (Key 4) 


Press Enter if ae are finished with your key definitions, or press Page Down to 


continue to 


as : ar > 
Display Report Definition - Keys ONDMD400 


1/08/98 14:58:50 
Report / Version cat spccis, eras ear ee eae ee BEES / 01 


Keys as “apres meu ttunstaseuete retvelnsn tere aa ueanes 
OMGEN Wsercruss cout cee satenkewrs treme tcarsnr cn eon sancontan: 0 
Minimum: Search characters! =... 2.6 os See 1 
Location: 


Henig hpeeercahereca rs pecme ss otemeeaiek cote acstcey ee ae 
GO UMM Serer ters ice ee tare os eee cuL eaten mre ats 


ooo 


Owen GaSe@Key~ sie s 2.5,  Cettecesit as cea ts UlN Y=Yes, N=No 
Key Security 2 6 ec woe ee we ae EOIN Y=Yes, N=No 
Musliekiey sy ee eas eeu become. chat woe) naa acs aN Y=Yes, N=No 

Bottom 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 69. Display Report Definition - Keys (Key 5) 


Press Enter to return to the Report ADMINISTRATION MENu,|Figure 3 on page 4 


Option 5. Work with Report Groups 


You can use the screens in this option to create, change, copy, delete, or display 
report group definitions. 
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A report group is composed of different, but related, reports. For example, you can 
include invoices, late payment notices, and monthly invoice summary reports in 
one group, with the invoice number as Key 1 and the customer number as Key 2. 
Name the group INVINFO, and when you search INVINFO by customer number 
12345678 or invoice number 876543, OnDemand lists all related items from the 
three different reports. 


Note: Once a report is defined to a group, you cannot change the report to belong 


to a different group unless you delete ALL reports by that Report Name first, then 
change the Report Group named in the Report Definition. 


To begin, select option 5, Work with Report Groups, from the Rerorr ADMINISTRATION 
MENU, |Figure 3 on page 4} or use iSeries Navigator for a graphical _user interface to 


this function. If you choose to use the non-graphical interface,|Figure 70| appears. 


( 5 


Work with Admin for OnDemand (WRKADMRDAR) 
Type choices, press Enter. 
Administrator function..... >*RPTGRP *REPORT, *RPTGRP, *RPTOVL... 
Report «Group's ic. ce tens) el poets *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 70. Work with Admin for OnDemand (WRKADMRDAR) 


Press Enter to continue. 


To Create a Report Group 


Use |Figure 71 on page 45|to create a report group definition. 
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Work with Report Groups ONDMD400 
1/04/98 11:21:35 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Group Text 

1 INVINFO__ 
MIKEAL Marks Group 
SHERRILL Performance testing 
TEST nn 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
7 
Figure 71. Work with Report Groups 
Press Enter to move to 
ro 
Create Report Group - Description ONDMD400 : 
1/04/98 11:22:28 
Type choices, press Enter. 
GIOUD ek fen to ter reuces once ca emeaneseon ve INVINFO__ Name 
Group abbreviation ....... INV 
EXC Rear caenteneats aace ot cceurede yee scecakrs Invoice-related info 
F3=Exit F12=Cancel 
7 


Figure 72. Create Report Group - Description 


Press Enter to continue to|Figure 73 on page 46 


Use the next two screens to define the key fields for all reports in the report group. 


When you use report groups, all of the reports in a group should have their keys 
and display fields defined to represent the same data elements. Further, these 
common keys and display fields should be defined in the report group definition 
in the same way. 
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The reason for this is important: When an end user chooses to perform a group 
search (across all reports within a group), the user would press Fé6 after entering a 
search (key) value. The Work witH Documents screen which then appears is the 
same format as would result from a single-report search. The only difference is that 
the resulting selection list of items that matches the search value may belong to a 
variety of different reports. Only one difference exists in the data on the screen. 
This difference being that the fifth column on the screen (Key 5) is replaced by the 
report name that the particular segment belongs to. All other columns display the 
Key 1, Key 2, Key 3, and Key 4 values. The data has been extracted from the data 
in the different reports. The column headings, therefore, must reflect a description 
of the data that appears in each column. If Key 3 contains Customer Name for 
Invoices but contains Order Number for Orders, then it is difficult for the user to 
correctly interpret what is shown. A concern exists for the Speciry DOCUMENT SEARCH 
screen. This screen allows input of the key value to search. The concern is the 
screen prompting for a field name that might not be the correct field name for 
which you are searching. 


In the example we created, INVINFO, all three report definitions, (and the report 
group definition), use Key 1 for the invoice number and Key 2 for the customer 
number. When you enter 12345 for Key 2 and press Fé for a group search, items 
out of all three reports may appear (if they match the search criteria of 12345). 


é 
Create Report Group - Keys ONDMD400 > 


1/04/98 11:22:57 
Group es 4 Gosh os ee Sw ee ce oe ee CINVINEO 


Type choices, press Enter. 


Key-cl- group Names caer sweet usar ss ve) Yeo Invoice # 
KONG ENG peveceee euese ecu cee eeren austen comes ten "en cs 10 =1-25 
Minimumssearchi-characters: 3.2)... Gos ce 3 1-25 
K@yS@CURTEY: ccc 3: Spur et eo oes sh tote ee as Ue Poy oe N Y=Yes, N=No 

Key 2 Group mame. 2.-seees cs tel oe ve. ca en eum oe Customer #__ 
IL-eloficl is merece war OU ert one ae Che acer ert eh 9 1-20, O=Not used 
Minimum search characters ......... 5 0-20 
Key2SOGUIIIEYS 20 sues eee cals eraneecaee: Gumeuee N Y=Yes, N=No 


Key 3:group. name> s 6 3s we 6 we ee OS 


Onigitht east tienen aca eie eat cates velbe 0 1-20, O=Not used 
Minimum search characters ......... 0 0-20 
Key security <2. 3 0% os wae we we we eS N Y=Yes, N=No 


More... 


F3=Exit F12=Cancel 


Figure 73. Create Report Group - Keys (1, 2, and 3) 


Press Page Down to move to |Figure 74 on page 47| 
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a 
Create Report Group - Keys ONDMD400 
1/04/98 11:24:12 
GrOUPis 4 eS Se ee Rs a ws Se INVINFO 
Type choices, press Enter. 
Key 4) group:iname: “s.06 -< ao ee ee ee 
Rengiths scaccacon ts roscoe tec eeuen eouncua ce Seat ne 0 1-20, Q=Not used 
Minimum search characters ......... 0 1-20 
Key ASCCUIIEY taerce cs. veils Uc us) eee eee tee eee N Y=Yes, N=No 
Key< Se GOUpiNAMe® Gey cscs seo tes es st fon tes Se ees ee 
Bengitlity teyecse tue cmes veuys cu eeue sie coms arte 0 1-15, Q=Not used 
Minimum search characters ......... 0 1-15 
Keys @CUI EV 2) <o-tsGden-tansciwtcecet rues ot ome eenme N Y=Yes, N=No 


F3=Exit F12=Cancel 


Bottom 


Figure 74. Create Report Group - Keys ( 4 and 5) 


Name this report group in the report definition for each report that belongs to this 


group. This lets end users retrieve these reports together by entering invoice 


number or customer number only once. 


Press Enter to return to |Figure 3 on page 4} the Report ADMINISTRATION MENUu. 


To Change a Report Group 


If you want to change a report group—its name or keys, for example—select 


option 5, Work with Report Groups from the Report ADMINISTRATION MENu. (See 
Figure 3 on page 4]) The screen, Work with ADMIN FoR ONDEMAND 


(WRKADMRDAR), |Figure 70 on page 44] appears. Complete it, and press Enter to 


move to|Figure 75 on page 48 
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a 
Work with Report Groups ONDMD400 


1/04/98 11:25:59 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Group Text 
ACCTG Reports for Accounting 

2 INVINFO Invoice-related reports 
INVENT Inventory Reports 
IS Information Systems Reports 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Figure 75. Work with Report Groups 
Press Enter to continue to 
Ga : 
Select Report Group Section to Change ONDMD400 


1/04/98 11:26:11 


Type selection, press Enter. 
1=Select 


Choose Section 
Description 
Keys 
1 All Sections 


F3=Exit F12=Cancel 


Figure 76. Select Report Group Section to Change 


You can change one of these parts of a report group by entering a 1 next to that 
part: 


Description 
To change the description of the report group. 


Press Enter to move to|Figure 77 on page 49] CHANGE Report GROUP - 


DESCRIPTION. 


Keys ‘To change any of the keys in the report group. 
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Press Enter to move to|Figure 78 on page 50) CHANGE Report Group - Keys. 


You can change the attributes of the entire report group. 


All sections 
Enter 1 to display all change screens in sequence. Press Enter to move to 


(— mae > 
Change Report Group - Description ONDMD400 
1/04/98 11:26:16 
GIRO U Pieeseai tn terse Momence tecture tesa :  INVINFO 
Group abbreviation .......: INV 


IkOXsC ss eae tetecrsraper Pours tice Lemouner fete saeciats cree ts Invoice-related reports 


F3=Exit  F12=Cancel 
e/ 


Figure 77. Change Report Group - Description 


To change the fields, type over the existing information. Press Enter. 


If you are changing only the description, |Figure 80 on page 51]appears, confirming 


your change. 


If you are changing fields on all screens, |Figure 78 on page 50|appears. 
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Change Report Group - Keys ONDMD400 
1/04/98 11:26:52 
GROUP 2 = 4 ee Se oe ow Swe we ce we INVINEO 


Type choices, press Enter. 


Key ali gmoupsinames: 50) fa. den eee teu sores spo ck oe Invoice # 
Wenig t Nie cecrsnee coer t cue mntsn tone t ce asters 10 =«1-25 
Minimum search characters ......... 3 1-25 
K@y-S@CUMDEY esc e™ecy vers: ce useuse tue laow sapeldes os N Y=Yes, N=No 

Key 2 gnoupsinames 052i ase ete la eee Customer #__ 
Wngithinvsnccee c-cncsety wom ncn et micrac tas uence 9 1-20, O=Not used 
Minimum search characters ......... 3 0-20 
Key SOGUIRIIEY = wares obi ce cules tomcamesn eae re N Y=Yes, N=No 


Key 3: group name: 2 < 34 6 wae we se He 


FENG ENR cupeecitnecaesae ence te cuit era ae 0 1-20, O=Not used 
Minimum search characters ......... 0 0-20 
Key security <2 24 4 8 wae He wes N Y=Yes, N=No 


More... 
F3=Exit F12=Cancel 


Figure 78. Change Report Group - Keys (1, 2, and 3) 


Type your changes over the existing information. If you do not need_to change Key 
4 or Key 5, press Enter. Otherwise, press Page Down to continue to 


ra 
Change Report Group - Keys ONDMD400 ) 


1/04/98 11:27:02 
GROUP Raaecasc ets este vaio ca ieutel ep reat eee mopiee ten ance -LNVIINEO 
Type choices, press Enter. 


Key*4sgiroupsiname® s,s 3G ee as Se ee a ds 


WONGENG eases come tst ncn toucan scenic mem tare duet oe 0 1-20, O=Not used 

Minimum search characters ......... 0 1-20 

Key 2S@GUIIIEYS wepestsnes es: cau baricen ses cer en eee ce N Y=Yes, N=No 
Keye5< GnOU PAN AME oer sien tecite pes eurceiomcase cena 6 

IEG ENE acer tecatsaecien: cae stlereomnceesm er sune 0 1-15, O=Not used 

Minimum search characters ......... 0 1-15 

Key security <3 sass & 36 we ee we N Y=Yes, N=No 


Bottom 
F3=Exit F12=Cancel 


Figure 79. Change Report Group - Keys (4 and 5) 


Type your changes over the existing information. Press Enter. |Figure 80 on page 51 


confirms your changes. 
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a ~ 


Select Report Group Section to Change ONDMD400 
1/04/98 11:27:04 


Type selection, press Enter. 
1=Select 


Choose Section 
Description 
Keys 
All sections 


F3=Exit F12=Cancel 
Group definition updated. 


Figure 80. Select Report Group Section to Change 


Press Enter to return to the Report ADMINISTRATION MENu,|Figure 3 on page 4 


To Copy a Report Group 


You can copy an existing report group definition and assign the copy a new name. 


For example, the screens show you a report group, INVINFO, that contains reports 
related to invoice information. To create a report group for purchase order 
information (with similar keys), copy the INVINFO report group, and name the 
new one POINFO. 


Select option 5, Work with Report Groups, from the Report ADMINISTRATION MENU, 
(see|Figure 3 on page 4). The screen, Work with ADMIN FoR ONDEMAND 
(WRKADMRDAR), [Figure 70 on page 44] appears. Complete it, and press Enter to 


move to |Figure 81 on page 52| 
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a 
Work with Report Groups ONDMD400 ) 
1/04/98 11:27:08 


Type options, press Enter. 


1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Group Text 

3  INVINFO Invoice-related reports 
MIKEAL Marks Group 
SHERRILL Performance testing 
TEST nn 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
eA 
Figure 81. Work with Report Groups 
Press Enter to move to 
ra 
Copy Report Group ONDMD400 > 
1/04/98 11:27:18 
Type New group and New abbreviation, press Enter. 
Group Abbreviation New group New abbreviation 
INVINFO INV POINFO__ POI 
F3=Exit F12=Cancel 
z/ 


Figure 82. Copy Report Group 


Press Enter to save the copy and return to the Report ApMINisTRATION MENu,|Figure 3 
lon page 4] 


To Delete a Report Group 


If you want to delete a report group, select_option 5, Work with Report Groups, 
from the Report ADMINISTRATION MENU, (see|Figure 3 on page 4). The screen, Work 
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witH ADMIN FOR ONDEMAND (WRKADMRDAR), |Figure 70 on page 44} appears. 
Complete it, and press Enter to move to|Figure 83 


a 
Work with Report Groups ONDMD400 +) 


1/04/98 11:27:48 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Group Text 

4  INVINFO Invoice-related reports 
MIKEAL Marks Group 
SHERRILL Performance testing 
TEST nn 


Bottom 


F3=Exit F5=Refresh  F12=Cancel 


Figure 83. Work with Report Groups 


Press Enter to delete the report group or F12 to cancel the request. If there are any 
reports archived with this group name, OnDemand does not allow you to delete 
the group definition. A confirmation panel is displayed to confirm the deletion. 


To Display a Report Group 
To see a report group definition, select option 5, Work with Report Groups 
Figure 70 on page 44) from the Rerort ADMINISTRATION MENU, |Figure 3 on page 4 


The screen, Work witH ADMIN FOR ONDEMAND (WRKADMRDAR 
appears. Complete it, and press Enter to move to |Figure 84 on page 54 
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a 
Work with Report Groups ONDMD400 


1/04/98 11:27:48 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Group Text 

5  INVINFO Invoice-related reports 
MIKEAL Marks Group 
SHERRILL Performance testing 
TEST nn 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Figure 84. Work with Report Groups 
Press Enter to move to 
fe : dee. 
Display Report Group - Description ONDMD400 


1/04/98 11:28:00 


GHOUDs eierncnsepevere, ces ease ne tt saree oie NVINEO 
Group abbreviation .......: INV 
MEXts “s204 cs i, Gr ft fee ete) sta er tans: e) ENVOLCe=reLated: reports: 


Bottom 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 85. Display Report Group - Description 


Press Enter to move to|Figure 86 on page 55 
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Display Report Group - Keys ONDMD400 
1/04/98 11:28:08 


GROUP! 25. 4 Saw ee HO se Se ee ee 2 INVIINEO 
Key Lo group: name... ss eo a we Se  Tnvolice:# 
Length) <s10 es eis eS ee es Ww ee we ee 10 
Minimum search characters .........3: 3 
Key, SCCURILY. 9ia-..ky ce wes sents co ponents cee ves N Y=Yes, N=No 
Key 2 group name... 8. ce ee ew we os OY Customer: # 
Bengtht arpa tss- sok st ea rca semen tes ashen eoteaur glen es 9 
Minimum search characters .........3: 3 
KEV SSCCUNILYS: Sattar so ecaie, yeoman seas couse ses N Y=Yes, N=No 
Keya3nQroupan ames r1 suceu- tae ectesd iene conkers ts 
engihiiees aeccmciet uct cw taeei se oruecae teresa trae ans 0 
Minimum search characters .........3: 0 
KEYS GU PILE) Gaiceesec meus eursec she eer ecste hie’ cates N Y=Yes, N=No 
More... 
Press Enter to continue. 
F3=Exit F12=Cancel 
4 
Figure 86. Display Report Group - Keys (1, 2, and 3) 
Press Page Down to continue to|Figure 87, 
Ss 
Display Report Group - Keys ONDMD400 y 
1/04/98 11:28:10 
GROUP 2. erento arena toners eetesie) seme mons NVIENEO 
Keyed GYOUDEMAMC sys) avukeucceurcanecsanen rene evures suns 
Peng thingies sable temper ectic) meaner as 0 
Minimum search characters .........3: 0 
Key S@Cunity 4.4 % <6 4% Gs Wes Sa N Y=Yes, N=No 
Key Segroupsmame? eis. cs: cy eee ton eesueteroy ome te sre 
Pengthit tae cewoct tered cr sa eters acon eo mere ie cans 0 
Minimum search characters .........3: 0 
KEYS CCU RTT sectais ca seq cay cen esee seus tos steeren fence N Y=Yes, N=No 
Press Enter to continue. 
Bottom 
F3=Exit F12=Cancel 
J 


Figure 87. Display Report Group - Keys (4 and 5) 


When you are finished viewing the report group definition, you can press Enter to 
continue to|Figure 88 on page 56 
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Work with Report Groups ONDMD400 
1/04/98 11:28:14 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Group Text 
INVINFO Invoice-related reports 
MIKEAL Marks Group 
SHERRILL Performance testing 
TEST nn 


Bottom 
F3=Exit F5=Refresh F12=Cancel 


Figure 88. Work with Report Groups 


You can select another_report group, or you can press Enter to return to the Report 
ADMINISTRATION MENu,|Figure 3 on page 4 


Option 10. Edit/Authorize OnDemand Users 


56 


There are two types of OnDemand users: End users and system administrators. 
The end user simply retrieves data from the archive and reacts accordingly; the 
system administrator is responsible for many things, such as creating report 
definitions, setting up the optical or tape environment, insuring that the data 
correctly migrates from one media to another, and granting access authority to the 
end users. 


Turn to|“Spool File Archive Security - In Detail” on page 126|/for a discussion on 


the group profile that is called QRDARSADM. This will enable OnDemand to 
identify you as a system administrator, and to grant you proper authority to 
perform the advanced administration functions. 


If you have been identified as a system administrator, then you can grant end 
users access to the archived data, using individual OS/400 user profiles or OS/400 
group profiles. 


To begin, select option 10, Edit/ Authorize OnDemand Users, from the ONDEMAND 
Report ADMINISTRATION MeNu screen, |Figure 3 on page 4 


Figure 89 on page 57|appears. 
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ia : ' cS 
Work with Security for OnDemand (WRKSECRDAR) 
Type choices, press Enter. 
Security function «2 « . «a 3 >*USER *USER, *RPTGRP, *REPORT, *KEY 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
rd 
Figure 89. Work with Security for OnDemand (WRKSECRDAR) 
Press Enter to continue to 
i 
Edit Authorization List +) 
Object. ..... . : QRDARS400 Owner . ...... : + QRDARS400 
Library i sr ge feet. QSYS Primary group ... :  *NONE 
Type changes to current authorities, press Enter. 
Object List 
User Authority Mgt 
QRDARS400 = *ALL x 
QRDARSADM = *ALL x 
TESTID *CHANGE_ 
TBROWN2 *CHANGE_ 
*PUBLIC *EXCLUDE 
Bottom 
F3=Exit F5=Refresh F6=Add new users 
Fll=Display detail object authorities F12=Cancel F24=More keys 
& y 
Figure 90. Edit Authorization List 
This screen displays the authorized users. Press F6 to continue to 
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Add New Users 


Object ...... =. : QRDARS400 Owner . ..... =. :  QRDARS400 
Library: ae note ce 2 QSYS Primary group ... :  ¥*NONE 


Type new users, press Enter. 
Object List 


User Authority Mgt 
TBROWN___—s- *CHANGE_ 


More... 
F3=Exit Fll=Display detail object authorities F12=Cancel F17=Top 
F18=Bottom 
Figure 91. Add New Users 
Press Enter to continue to 
ie recor 
Edit Authorization List 
Object . ..... =. :  QRDARS400 Owner ...... =~ 2 QRDARS400 
EVD RARY) he Gee oo ser bas 2 QSYS Primary group ... :  *NONE 
Type changes to current authorities, press Enter. 
Object List 
User Authority Mgt 
QRDARS400 = *ALL Xx 
QRDARSADM = *ALL Xx 
TESTID *CHANGE_ 
TBROWN2 *CHANGE_ 
TBROWN *CHANGE_ 
* PUBLIC *EXCLUDE 
Bottom 
F3=Exit F5=Refresh F6=Add new users 
Fll=Display detail object authorities F12=Cancel F24=More keys 
Object authorities changed. 


Figure 92. Edit Authorization List 


This screen confirms your addition. 


Press Enter to return to the OnDemand Report Administration Menu. 


Option 11. Edit/Authorize OnDemand Report Users 


You must grant each user of a report access to that report. 
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To do this, select option 11, Edit/ Authorize OnDemand Report Users, from the 
Report ADMINISTRATION MENu,|Figure 3 on page 4| Press Enter to continue to 


i 
Work with Security for OnDemand (WRKSECRDAR) 
Type choices, press Enter. 
Security function: 205 + a es >*REPORT *USER, *RPTGRP, *REPORT, *KEY 
Report:name: 2. coe eee tas Name, F4 for list 
Bottom 

F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 93. Work with Security for OnDemand (WRKSECRDAR) 


To display the available report names, press F4 to continue to |Figure 94 


ja 
Specify Value for Parameter REPORT 


Type choice, press Enter. 


Ty PO@itea stvencs: reser yer ee tence peter ess (NAME 
REPOnCANAMe, ceca eins Reureaes neers checkstmts 
AGEDOC BILLS 
AGEOPN BRMS50 
AIC250 BUDGET 
ANNOUNCE CHECKSTMTS 
APCHK GLDAILY 
AP437 GLTRANS 
BEL3549 GLXXX 


+ 


F3=Exit F5=Refresh  F12=Cancel F13=How to use this display F24=More keys 


S 


Figure 94. Specify Value for Parameter REPORT 


Press Enter to continue to|Figure 95 on page 60 
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{ea 


Work with Security for OnDemand (WRKSECRDAR) 
Type choices, press Enter. 
Security function . . 3. . «« >*REPORT *USER, *RPTGRP, *REPORT, *KEY 
Report Wane « « ss 6 wwe « >CHECKSTMTS Name, F4 for list 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 95. Work with Security for OnDemand (WRKSECRDAR) 


This screen displays the report name you selected. 


Press Enter to move to 


a 
Edit Authorization List 


Object wo. 6 ese ci, ~CHECKSIIMIS Owner . .... ~~ 2  QRDARS400 
Ebay. = aie os: Reo QSYS Primary group ... :  ¥*NONE 


Type changes to current authorities, press Enter. 


Object List 


User Authority Mgt 
QRDARS4003  *ALL Xx 
QRDARS400 =*ALL_ Xx 
QRDARSADM =*ALL Xx 
SUSAN *USE 


*PUBLIC *EXCLUDE 


Bottom 
F3=Exit F5=Refresh F6=Add new users 
Fll=Display detail object authorities F12=Cancel F24=More keys 


Figure 96. Edit Authorization List 


This screen captures information from the iSeries system, displaying current 
authorization status for the report, CHECKSTMTS. 


Press F6 (F6=Add new users) to continue to|Figure 97 on page 61 
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fe 
Add New Users =) 
Object: <5 20%, «is ct ~~ CHECKSIMIS Owner... .... : QRDARS400 
Eibrany fois feet ss QSYS Primary group ...:  ¥*NONE 
Type new users, press Enter. 
Object List 
User Authority Mgt 
TBROWN___—s *USE. 
More... 
F3=Exit  Fll=Display detail object authorities F12=Cancel F17=Top 
F18=Bottom 
of 
Figure 97. Add New Users 
Press Enter to move to 
i 
Edit Authorization List +) 
Obyectss s.c4 ahs see, ~CHECKSTMTS Owner . ..... . : QRDARS400 
Library i sr ge focet. QSYS Primary group ...:  *NONE 
Type changes to current authorities, press Enter. 
Object List 
User Authority Mgt 
QRDARS4003 *ALL_ x 
QRDARS400 = *ALL_ x 
QRDARSADM = *ALL_ Xx 
SUSAN *USE 
TBROWN *USE 
*PUBLIC *EXCLUDE 
Bottom 
F3=Exit F5=Refresh F6=Add new users 
Fll=Display detail object authorities F12=Cancel F24=More keys 
Object authorities changed. 
y 
Figure 98. Edit Authorization List 
This screen confirms your addition. 
Press Enter to return to the Report ADMINISTRATION MENu,|Figure 3 on page 4 
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Option 12. Edit/Authorize OnDemand Report Group Users 


If you are the OnDemand system administrator, it is your responsibility to grant 
users access authority to report groups. 


To do this, select option 12, Edit/Authorize OnDemand Report Group Users, from 
the Report ADMINISTRATION MENu,|Figure 3 on page 4} Press Enter to continue to the 


Work WITH SECURITY FOR ONDEMAND (WRKSECRDAR) screen, |Figure 99 


a 
Work with Security for OnDemand (WRKSECRDAR) ) 
Type choices, press Enter. 
Security function: .. 06% a. a >*RPTGRP *USER, *RPTGRP, *REPORT, *KEY 
Reportegroupis get cerrse 6 ce* cee ele Name, F4 for list 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
y 
Figure 99. Work with Security for OnDemand (WRKSECRDAR) 
fe > 
Specify Value for Parameter RPTGRP 
Type choice, press Enter. 
WY POseee ce ey a ee en ce eto ener eee css NAME 
REPORT GROUP Par. ctvan: cane) eet ten invinfo__ 
INVINFO 
MIKEAL 
SHERRILL 
TEST 
F3=Exit F5=Refresh  F12=Cancel F13=How to use this display F24=More keys 
NS oy 


Figure 100. Specify Value for Parameter RPTGRP 


A list of report groups appears. 
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Press Enter to move to Work WITH SECURITY FOR ONDEMAND (WRKSECRDAR), 


Pe 
Work with Security for OnDemand (WRKSECRDAR) 


Type choices, press Enter. 


Security function .% 4 >*RPTGRP *USER, *RPTGRP, *REPORT, *KEY 
Report Groups. vs eee eee, 2 pe cs >INVINFO__ Name, F4 for list 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 101. Work with Security for OnDemand (WRKSECRDAR) 


The report group you selected is verified on this screen. 


Press Enter to move to Epir AuTHorizaTION List,|}Figure 102 


e Pe Tee 
Edit Authorization List 


Object ccc. woaee < INVINEO Owner . .... ~~ 2  QRDARS4005 
Library: st. sax esses: QSYS Primary group ...:  *NONE 


Type changes to current authorities, press Enter. 


Object List 
User Authority Mgt 
QRDARS4005 =*ALL x 
QRDARS400 = ALL x 
QRDARSADM = *ALL x 
* PUBLIC *EXCLUDE 


Bottom 


F3=Exit F5=Refresh F6=Add new users 
Fll=Display detail object authorities F12=Cancel F24=More keys 


S 


Figure 102. Edit Authorization List 


This screen captures information from the iSeries system, displaying current 
authorization status for the report group INVINFO. 
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Press Fé (F6=Add new users) to continue to App New Ussrs,|Figure 103 


Ps 
Add New Users 


Object: 3 ee ee  IINVINEO Owner . .... ~~ 2 ~~ QRDARS4005 
Library «3 < 34 QSYS Primary group ... :  *NONE 


Type new users, press Enter. 
Object List 


User Authority Mgt 
TBROWN ss *USE. 


More... 
F3=Exit Fll=Display detail object authorities F12=Cancel  F17=Top 
F18=Bottom 
Figure 103. Add New Users 
Press Enter move to the Eprr AutHorizaTIoN List,|Figure 104) 
a Ser 
Edit Authorization List 
Object <2 seis eo CINVINFO Owner . .... ~~ 3  QRDARS4005 
evbranys <2 ee feo te? QSYS Primary group ... :  ¥*NONE 
Type changes to current authorities, press Enter. 
Object List 
User Authority Mgt 
QRDARS4005 *ALL Xx 
QRDARS400 = *ALL Xx 
QRDARSADM = *ALL Xx 
TBROWN *USE. 
* PUBLIC *EXCLUDE 
Bottom 
F3=Exit F5=Refresh F6=Add new users 
Fll=Display detail object authorities F12=Cancel F24=More keys 
Object authorities changed. 


Figure 104, Edit Authorization List 


The confirmation message appears. 


Press Enter to return to the Report ADMINISTRATION MENu,|Figure 3 on page 4 
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Option 13. Work with Key Security 


As the OnDemand system administrator, you can limit user access authority to 
particular portions of a report. You can do this by granting individual users access 
to specific ranges of key values; this excludes them from accessing any other 
segments of the report using that key field. You can do this with a user profile, 
group profile, or the generic profile named *PUBLIC. 


For each key of the report: 


* A *PUBLIC entry, with the key range *ALL, grants all users access to all 
segments of the report, unless you gave them other explicit authorizations. 
If you define *PUBLIC with a key range *ALL, and define a particular user (or 
group) profile for a specific key range, that user (or group) can view only those 
segments within the authorized key ranges. That user (or group) cannot access 
the rest of the report. All other users have access to all segments of the report. 
If you do not use *PUBLIC, only those who have authorizations for their own 
user profile or group profile can see any of the report. 


For more examples and _a full description of OnDemand security, turn to[“Spool| 
File Archive Security - In Detail” on page 126 

To grant access to key values, select option 13, Work with Key Security, from the 
ONDEMAND Report ADMINISTRATION MENU screen, Figure 105 


appears. Note that you must also specify Y in the Key security field in the report 
definition on each key for which security is being defined. 


va 
Work with Security for OnDemand (WRKSECRDAR) >) 
Type choices, press Enter. 
Security function « 2 <5 % a + >*KEY *USER, *RPTGRP, *REPORT, *KEY 
Reportename: ies. ee ih hoe ce checkstmts Name, F4 for list 
VGnSi OM cst Bares toa sseseren suns: Benes 01__ 01-99 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 105. Work with Security for OnDemand (WRKSECRDAR) 


Press Enter to continue to|Figure 106 on page 66 
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a -* 


Select Keys for Security ONDMD400 
1/31/98 17:32:22 


Report .« <= . <2 CHECKSIMIS 
VenSTON(iese se sets en Ol 
Text ..... : Check Statements (OnDemand Example) 
Type options, press Enter. 
1=Select 
Option Key Security 
Account Number Not Enabled 
SSN / Tax-ID Not Enabled 
Cust Name Not Enabled 


Bottom 


F3=Exit F12=Cancel 


Figure 106. Select Keys for Security 


This screen displays a list of keys defined for the report. 


To Grant Key Authority 


Type 1 next to the key to which you are granting access. The example uses 
Account Number, which is defined as Key 1 for CHECKSTMTS. 


Press Enter to continue to the Work witH Key 1 Security screen,|Figure 107 on 


Note: Follow the same instructions used for key 1 when working with keys 2, 3, 4, 
or 5. The screen layouts are the same with the exception of the Key field. 
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Work with Key 1 Security 


Report .. . :  CHECKSTMTS 
Key 1... . : Account Number 


Type options, press Enter. 
1=Create 2=Change 4=Delete 


Option Low value High value 
1 000000000 2999999999 


ONDMD400 
1/31/98 17:29:36 


Profile name 
ft 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
7 
Figure 107. Work with Key 1 Security 
a : ») 
Create Key Range Security ONDMD400 
1/31/98 17:30:06 
REPORT are scater toate mesos sun sears CHECKSTMTS 
Key To. 4% 4 ee eo ee ew ee : ~Account Number 
Type choices, press Enter. 
Key range: 
Low!valliue 2: 6.35: ip cep oe si 000000000 
High Values <i.26 ee ok sen 299999999 
Profiile.name <. sos %. <<: % TBROWN 
QRDARS400___ 
MAMIKEAL__ 
NOBRIEN__ 
REPPLEY___ 
CALLEN 
F3=Exit F12=Cancel 
No y 
Figure 108. Create Key Range Security 
Press Enter to move to |Figure 109 on page 68 
67 
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Work with Key 1 Security ONDMD400 
1/31/98 17:32:02 
Report ... :  CHECKSTMTS 
Key 1... . : Account Number 


Type options, press Enter. 
1=Create 2=Change 4=Delete 


Option Low value High value Profile Name 

000000000 299999999 CALLEN 

000000000 299999999 QRDARS400 
000000000 299999999 MAMIKEAL 
000000000 299999999 NOBRIEN 
000000000 299999999 REPPLEY 
000000000 299999999 TBROWN 

Bottom 


F3=Exit F5=Refresh  F12=Cancel 
Security for key added, F5 for Refresh. 


yy 
Figure 109. Work with Key 1 Security 
This screen confirms your addition. 
To Change Key Authority 
Use |Figure 110)to change an existing key 1 security authorization. 
( Work with Key 1 Security ONDMD400 
1/31/98 17:31:15 
Report: 2.5.2 3 CHECKSTMTS 
Key 1... . =: Account Number 
Type options, press Enter. 
1=Create 2=Change 4=Delete 
Option Low value High value Profile Name 
000000000 299999999 CALLEN 
000000000 299999999 QRDARS400 
000000000 299999999 MAMIKEAL 
000000000 299999999 NOBRIEN 
000000000 299999999 REPPLEY 
A 000000000 299999999 TBROWN 
Bottom 
F3=Exit F5=Refresh  F12=Cancel y, 


Figure 110. Work with Key 1 Security 


Press Enter to move to|Figure 111 on page 69 


Note: Follow the same instructions used for key 1 when working with keys 2, 3, 4, 
or 5. The screen layouts are the same with the exception of the Key field. 
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‘a Change Key Range Security ONDMD400 
1/31/98 17:31:35 
Report 2.3. S2<. «= « i CHECKSIMTS 
Key 1 one ee ee se ss 2 ~©6Account Number 


Type choices, press Enter. 


Key range: 
Kow:vailiue: js au Geiser cs Ye) 500000000 
Haigh Valle: 4... ee 599999999 
Profile name ....... TBROWN___ 


F3=Exit  F12=Cancel 


ye 
Figure 111. Change Key Range Security 
Press Enter to view the change on|Figure 112 
( Work with Key 1 Security ONDMD400 i. 
1/31/98 17:31:46 
Report .. . :  CHECKSTMTS 
Key 1... . : Account Number 
Type options, press Enter. 
1=Create 2=Change 4=Delete 
Option Low value High value Profile Name 
000000000 299999999 CALLEN 
000000000 299999999 QRDARS400 
000000000 299999999 MAMIKEAL 
000000000 299999999 NOBRIEN 
000000000 299999999 REPPLEY 
500000000 599999999 TBROWN 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 
7 
Figure 112. Work with Key 1 Security 
This screen displays the changes. 
To Delete Key Authority 
Use |Figure 113 on page 70|to delete key access for a user or group profile. 
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Work with Key 1 Security ONDMD400 
1/31/98 17:32:04 


Report ... :  CHECKSTMTS 
Key 1... . : Account Number 


Type options, press Enter. 
1=Create 2=Change 4=Delete 


Option Low value High value Profile Name 

000000000 299999999 CALLEN 
000000000 299999999 QRDARS400 
000000000 299999999 MAMIKEAL 
000000000 299999999 NOBRIEN 
000000000 299999999 REPPLEY 

4 500000000 599999999 TBROWN 

Bottom 


F12=Cancel 


F3=Exit F5=Refresh 
NSE” / 


Figure 113. Work with Key 1 Security 


Press Enter to continue to|Figure 114 


Note: Follow the same instructions used for key 1 when working with keys 2, 3, 4, 
or 5. The screen layouts are the same with the exception of the Key field. 


a 
Confirm Delete of Key Security ONDMD400 >) 
1/31/98 17:32:12 
REPOME: foc iat sens eee ce ct HCHECKSIMIS: 
Keyan liye ercres! iaverveuseesat rus : Account Number 
Press Enter to confirm your choice for 4=Delete 
Press Fl2=Cancel to return to change your choices. 
Key range: 
Low value. ....... : 500000000 
High value .......: 599999999 
Profile name ...... .:  TBROWN 
F12=Cancel 
eA 


Figure 114. Confirm Delete of Key Security 


If = entered the correct data to delete, press Enter to move to|Figure 115 on| 


If you entered incorrect data, press F12 to return to|Figure 113 
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Work with Key 1 Security ONDMD400 
1/31/98 17:32:15 
Report .. . :  CHECKSTMTS 
Key 1... . : Account Number 


Type options, press Enter. 
1=Create 2=Change 4=Delete 


Option Low value High value Profile Name 
000000000 299999999 CALLEN 
000000000 299999999 QRDARS400 
000000000 299999999 MAMIKEAL 
000000000 299999999 NOBRIEN 
000000000 299999999 REPPLEY 
500000000 599999999 TBROWN 
Bottom 


F3=Exit F5=Refresh F12=Cancel 


See ee a ee a SS See 


Figure 115. Work with Key 1 Security 


This screen confirms the deletion. 


Option 20. Report Definition Menu 
To work with reports, access the Reporr ADMINISTRATION MENU screen, [Figure 3 on| 


Select option 20,|Figure 116 


Fa 
ONDMDDEF OnDemand Report Definition Menu 
System: | ONDMD400 
Select one of the following: 


. Retrieve Reports 

. Store Report 

. Delete Report 

. Create Physical File 

. Copy Spooled File 

. Display Physical File Member 

. Work with Report Definition 

. Work with Spooled Files 

. Work with Output Queue 

Print AFP Text Data for Report Definition 


GOON anFWNMYE 


ray 


nN 
f<>) 


. Report Administration Menu 


Selection or command 


===> 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
F16=System Main Menu 
(C) Copyright IBM Corp. 1992, 2000. All Rights Reserved. 


Figure 116. OnDemand Report Definition Menu 


The screen options are all included in this section; this screen is not repeated. 
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Option 1. Retrieve Reports 
Retrieving reports is an end-user function, and is described in|Chapter 8, “For the 
OnDemand Spool File Archive End User” on page 277 

Option 2. Store Report 
Use these screens to store (capture) a report you defined. To begin, select_option 2, 
Store Report, from the ONDEMAND Report DEFINITION MENU, |Figure 116 on page 71 
The Start Copep Data Store (STRCDSRDAR) screen, |Figure 117] appears. 


( ms 


Start Coded Data Store (STRCDSRDAR) 

Type choices, press Enter. 
Report WaM@ 5 «6 3 % ws & ¥ os CHECKSTMTS Name, F4 for list 
VEHSTONT: 2, con ae. eh 68 csricst o> Mec ss vie 01 01-99, *HIGHEST 
Text: “description: soc. %, ee *BLANK 
DM PUEA RTGS ey eo at ee cee ce) en ee Gee oe *SPLF Name, *SPLF 

WD Raley mets cecete nec tceee ane rs Name, *LIBL, *CURLIB 

Bottom 

F3=Exit F4=Prompt F5=Refresh F10Q=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 117. Start Coded Data Store (STRCDSRDAR) 


Press Enter to continue to|Figure 118 on page 73 
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a 
Start Coded Data Store (STRCDSRDAR) 
Type choices, press Enter. 
Report: names 5 es oa see ee as > CHECKSTMTS Name, F4 for list 
VerSTOND “e. sod 2 ce Se ee OS Oe 01 01-99, *HIGHEST 
Text. “description! <2. 4% 2 ace *BLANK 
INPUT: AG! s. Se eo eee ee ee Sed sees *SPLF Name, *SPLF 
[brary terre erates eure tres chee Name, *LIBL, *CURLIB 
SPOOM Gd iCivcs Aas. ve: te ee oe as QSYSPRT___ Name 
JODSNAMC Reece, vepenesasioe es eel eiee * Name, * 
US Crgcnacies mera cene wcclee res eee aes Name 
NUMBER cathe gs yee te cor te aac 000000-999999 
Spooled file number ...... *ONLY_ 1-999999, ONLY, *LAST 
Delete input file ....... *NO_ *NO, *YES 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 118. Start Coded Data Store (STRCDSRDAR) 


(If you entered *SPLF in the Input File field on the previous screen, additional 
fields appear on this screen.) 


Press Enter to begin capturing the report, or F10 to verify or change additional 
parameters. 


Results of the report capture are written_to a report with the spooled file name 
OPRLRCDS. To view this report, select |“Option 8. Work with Spooled Files” on 
ipage 80} from the ONDEMAND Report DEFINITION MENU, 


Figure 116 on page 71 


Option 3. Delete Report 


To delete a stored report, select this option from the ONDEMAND Report DEFINITION 
MENU, |Figure 116 on page 71||Figure 119 on page 74| appears. 
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(e ~ 


Delete Report for OnDemand (DLTRPTRDAR) 
Type choices, press Enter. 
Reportnames sc. 45 Wei se ene CHECKSTMTS Name, F4 for list 
Version . 4.4 4 5 4 = wie « 01 01-99 
Reportsdate: = 2 2 i505 cs hee est ce 19950331 Date (YYYYMMDD) 
Report sequence number. .... 001 001-999 

Bottom 

F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 119. Delete Report for OnDemand (DLTRPTRDAR) 


When you are finished, press Enter, or F10 to verify or change additional 
parameters. 


If an error occurs during the report deletion, the errors are written to a report with 
the spooled file name OPRLCERR. To view this report, select]“Option 8. Work 
ith Spooled Files” on page 80}from |Figure 116 on page 71 
Option 4. Create Physical File 


To find segmentation values and key information in a report, you must copy the 
spooled output data into a physical file; then you can locate the line and column 
positions of the data. Do this only once—when you first define the report to 
OnDemand. Copying of the spooled file data is described in Option 5. 


Note: If your spooled file contains AFPDS, do not follow this process. Instead, 
choose}“Option 10. Print AFP Text Data for Report Definition” on page 80]/from the 
Report DerFiniTiON MENu to create a printout that shows the data portion of the 


AFPDS report. This lets you identify the row and column positions in a similar 
manner. 


First, create the physical file to contain the data. Choose option 4, Create Physical 
File, to move to|Figure 120 on page 75 
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VES 


Create Physical File (CRTPF) 


Type choices, press Enter. 


(Ralil KW eryasratr nese ce rere rue aeen Pear oee i CHECKSTMTS Name 

Bibrany’ 2 Saves vaccas oe oes MYLIB Name, *CURLIB 
Record length, if no DDS... . > 133 Number 
Generation severity level ... 20 _ 0-30 
Flagging severity level .... @O__ 0-30 
Member, if desired. ...... *FILE Name, *FILE, *NONE 
Text: “description: «2 <. © <.. *SRCMBRTXT. 


Bottom 
F3=Exit F4=Prompt F5=Refresh F12=Cancel 


F13=How to use this display 


F10=Additional parameters 
F24=More keys 


Figure 120. Create Physical File (CRTPF) 


The fields you use are File, Library, and Record Length, if no DDS. 


Usually, you can enter 133 for a standard green-and-white bar-paper report that is 
132 characters wide (plus one for the carriage control character). Other reports, 
such as invoices, might require a record length of 81 (80 columns of the report, 
plus a one-character carriage control.) 


To determine the correct value for this field, you can display the spooled file 
attributes of the report being defined, and look for the Width field in the Page size 
parameter. Add one to this value to allow for the carriage control character. 


* Leave the defaults in the remaining fields. 

¢ Press F10 (F10=Additional parameters). 

* If you press Page Down to the second screen, consider the Initial number of 
records field. Enter *NOMAX or the number of report lines you want to use. 


If your report has 10 000 or more lines of data, we suggest that you test with 
only 10% of them. When your report stores correctly, run at least one test with 
the entire report. 


Press Enter to create the physical file. 


Option 5. Copy Spooled File 


To find segmentation values and key information in a report, copy the report 
spooled file into a physical file. Do this by using the first character forms control 
(*FCFC) parameter of the Copy Spooled File (CPYSPLF) command. 


The new file then contains your spooled data with a carriage control character as 
the first character of each line of data. If you display the physical file, and position 
the file at the top of a page (forms control character 1 is the first character of the 
line), you can determine the location of segmentation, index, and display data. 


Creating a physical file and copying spooled data into it is required only 
once—during the initial report definition phase. Then reports are typically 
captured directly from the spooled file. 
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Note: If your spooled file contains AFPDS, do not follow this process. Instead, 
choose}“Option 10. Print AFP Text Data for Report Definition” on page 80]from the 
Report DerFiniTioON MENu to create a printout that shows the data portion of the 


AFPDS report, allowing you to identify the row and column positions in a similar 
manner. 


To find the information about the spooled file needed in order to copy the spooled 
file report data to a physical file (that you created with |“Option 4. Create Physical 
File” on page 74) do this: 

* Select option 9, Work with Output Queue, from the ONDEMAND Report DEFINITION 


Ment, |Figure 116 on page 71} and enter the output queue name that contains 
your spooled file. 


OR 
* On the OS/400 command line, type: 
WRKOUTQ <queue name that contains the spooled file> 


For example, if the spooled file is in the queue TESTQ, the command is: 
WRKOUTQ TESTQ 


Press Enter to move to|Figure 121 
ie s 


Work with Output Queue 


Queue: PRTO1 Library: QUSRSYS Status: RLS 


Type options, press Enter. 
1=Send 2=Change 3=Hold 4=Delete 5=Display 6=Release 7=Messages 


8=Attributes 9=Work with printing status 
Opt File User User Data Sts Pages Copies Form Type Pty 
QSYSPRT DAVE RDY 2881+ 1 *STD 5 
CHECKS LOUISVIL CHKO1RPG SAV 504 1 INV 5 
QSYSPRT BOB *PRINT* HLD 4x 1 *STD 5 
QSYSPRT DAVE SAVE HLD 4x 1 *STD 5 
QPQUPRFIL SUE SAV 2 1 *STD 5 


Parameters for options 1, 2, 3 or command 

===> 

F3=Exit Fll=View 2 F12=Cancel F20=Writers F22=Printers 
F24=More keys 


SSS sss 


Figure 121. Work with Output Queue 


You will need to type 9 (9=Work with printing status) next to the report you want 
to use. 


Press Enter to move to|Figure 122 on page 77 
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Work with Printing Status 


JOD; sete ew eee ce UDSPO5 Fillieee Soin ce coc CHECKS 
WSOP eats aa ees LOUISVIL Numbers 3 0s. Ae 4 
Number ecs. See tn pons 020389 Sern idata. 3 nk CHKO1RPG 


Type options, press Enter. 
2=Change status 5=Display detailed description 


Opt Status Description 
This file is not associated with a started printer. 


Bottom 
Command 
sao 


F3=Exit F4=Prompt F5=Refresh F9=Retrieve F12=Cancel 


Figure 122. Work with Printing Status 


This screen displays the information for the file you selected. 


Record this information to use when you copy the spooled file into a physical file 
to define key positions, segmentation, and others (see below). 


Press Enter to return to the ONDEMAND Report DEFINITION MENu,|Figure 116 on 


Pas 
To copy a spooled file to the new physical file, choose option 5, Copy Spooled File, 
from the ONDEMAND Report DEFINITION MENu,|Figure 116 on page 71 


Figure 123 on page 78] appears. 
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a > 


Copy Spooled File (CPYSPLF) 


Type choices, press Enter. 


Spooled- filers 2. ees os ev yenne checks___ Name 
Tordatabase file: 3 <2 te 6. checkstmts Name 

EDGR Ye arses co toy eevee nee eomen mylib Name, *LIBL, *CURLIB 
VO DMMAMe2s<. nena, Gee coh aagsces ar ce fetes dsp05 Name, * 

US OY ee reniceure: ne tpet eure. oenicet Man See louisvil__ Name 

Numberesarectoe se crswe ateies reds 020389 =: 000000-999999 
Spooled file number ...... 4 1-9999, *ONLY, *LAST 
Mormember “asi. 4 dey te ces tou ces ce Seo *FIRST Name, *FIRST 
Replace or add records ..... > *REPLACE *REPLACE, *ADD 


Additional Parameters 


Control character «=. . = « « <-< > *FCFC *NONE, *FCFC, *PRICTL... 

Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 123. Copy Spooled File (CPYSPLF) 


Press Enter to copy the spooled file into the physical file. 


Option 6. Display Physical File Member 


From the Report DeFIniTion MENu (see|Figure 116 on page 71) select option 6, 
Display Physical File Member. |Figure 124 on page 79| appears. 

Note: If your spooled file contains AFPDS, do not follow this process. Instead, 
choose}“Option 10. Print AFP Text Data for Report Definition” on page 80|from the 
Report DeFINITION MENu to create a printout that shows the data portion of the 


AFPDS report. This lets you identify the row and column positions in a similar 
manner. 
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Display Physical File Member (DSPPFM) 


Type choices, press Enter. 


Fei@ses cae mest eco neue sees tee reucsy cents CHECKSTMTS Name 

IIDRARVS Se saves: seweesate on ea MYLIB Name, *LIBL, *CURLIB 
Member 5 4) a wy ee St ee *FIRST Name, *FIRST, *LAST 
FROM Records sss, 2) ets ees es 1 Number, *END 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 124. Display Physical File Member (DSPPFM) 
Press Enter to continue to the DispLay PuysicaL Fite Memper screen, |Figure 125 
Ps 
Display Physical File Member +) 
File <a ge :  CHECKSTMTS Library ....:  MYLIB 
Member . . . . . :  CHECKSTMTS Record ss. 1% 23 1 
Control) 2.7.5. 23%. Codumnis 3 ee ee 1 
Fades ence ce: ose oe 
eehennc lence ene echoes so chee heen deed vest bean hare Doses heme reemet res 
1 
P. 0. BOX 897 
MYRTLE BEACH, S.C. 29578 
LMW INC DBA LOCAL METALWORKERS aie 
P 0 BOX 14664 
SURFSIDE BEACH sc 
+ SURFSIDE BEACH SC 29587 
0 
OPAGE 1 OF 2 
More... 
F3=Exit F12=Cancel F19=Left F2Q=Right F24=More keys 
04-25 SA MW KS IM II $1 SYS400C4 KB 


Figure 125. Display Physical File Member 


Viewing this file lets you determine data locations (lines and columns) within the 
report data. 


Option 7. Work with Report Definitions 


When you select this option, the screens and fields that appear are the same as 
those in|“Option 4. Work with Report Definitions” on e 18} Turn to that section 
for complete instructions. 
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Option 8. Work with Spooled Files 


This is an OS/400 command that appears on the OnDemand menu for your 
convenience. 


Option 9. Work with Output Queue 


This is an OS/400 command that appears on the OnDemand menu for your 
convenience. 


Option 10. Print AFP Text Data for Report Definition 


To print AFP or SCS data not processed by Copy Spooled File text data for 
defining division into segments, key, and display field values for AFPDS spooled 
files, access the Report DEFINITION MENU screen, Do this rather 
than options 4, 5, and 6 (Create Physical File, Copy Spooled File, and Display 
Physical File Member) for AFPDS spooled files; OS/400 does not permit Copy 
Spooled File on AFPDS data. The Copy Spooled File command may also omit 
some full SCS attributes. If your SCS spooled file fails to copy with Copy Spooled 
File, change your OnDemand Report data type to *SCS (instead of *OTHER) and 
use PRTTXTRDAR to define the report. If Copy Spooled File successfully copies 
your spooled file data, then a Report data type of *OTHER should process 
successfully for you. 


Select this option to move to|Figure 126 


(ie >) 


Print AFP Spooled File Text (PRTTXTRDAR) 

Type choices, press Enter. 
Spoolied Tile «so 365 we ee afpdsout__ Name 
WODiMAMe. <> se, ton Wot cen csn ten sd cet cen dsp11 Name, * 

WS CTE sancomamceurcmucwcmrcanenacr scatcomrs DAVE Name 

Number’. 3 <3 & = ee Se GS 030256 —=—s-—-« Q00000-999999 
Spooled file number ...... *ONLY 1-999999, *ONLY,*LAST 
Page range to print: 

Starting, page = 3 < 2 = « x i Number 

Ending page 2 oesten reustese es veda 10 Number, *END 
Report Name sc. 5 61%, 6: se ies ee *NONE. 
VEVSTON 2 aan we se ee 01 01-99, *HIGHEST 

Bottom 

F3=Exit F4=Prompt F5=Refresh F10Q=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 126. Print AFP Spooled File Text (PRTTXTRDAR) 


Note the two new fields Report name and Version. 


Report name 
Report name specifies the name of the report definition to use when 
printing the spooled file. 


Generally, *NONE is the correct value to use for the report definition 
name. However, there are times when using a specific report definition is 
necessary. In V4R4M0, OnDemand introduced an improved method of 
determining how to print AFP data. 
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This new method results in more accurate column locations for indexing. 
But these column locations will likely be different than they would have 
been before the introduction of this new method. So if you are using 
PRTITXTRDAR to index a new report or a new version of an existing 
report, use *NONE for the report name. *NONE always uses the improved 
method of printing. 


Version 
You are required to use Version only if you specify Report name, and have 
the system ignore if Report name is *NONE. 


Press Enter to create the listing of the data. The data is written to a report with the 
spooled file named QPRLRTXT. 


Option 21. Report Utility Menu 


To work with OnDemand utility functions, access the Report ADMINISTRATION MENU 


screen, Select option 21, Report Utility Menu, |Figure 127 


RDARUTL OnDemand Report Utility Menu 
System: | ONDMD400 
Select one of the following: 


. Store Report 

. Delete Report 

. Print Report 

. Start Report Management Cycle 
. Start Monitor Output Queue 

. End Monitor Output Queue 


DAoarwnrnr 


10. Report Definition Menu 


20. Report Administration Menu 


Selection or command 
===> 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
F16=System Main Menu 
©) Copyright IBM Corp. 1992, 2000. All Rights Reserved. 


Figure 127. OnDemand Report Utility Menu 


Option 1. Store Report 


When you select this option, the screens and fields that a 


ppear are the same as 
those in|“Option 20. Report Definition Menu” on page 71}|"Option 2. Store Report” 


Turn to that section for complete instructions. 


Option 2. Delete Report 
When you select this option, the screens and fields that appear are the same as 
those in|“Option 3. Delete Report” on page 73 
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Option 3. Print Report 


To print an entire spooled file report after it is segmented and stored, choose 
option 3, Print Report, from the ONDEMAND Report Utiuity Menu. |Figure 128 


appears. 
ia 
Print Report for OnDemand (PRTRPTRDAR) *) 

Type choices, press Enter. 

Report name: < «es 6 we we eS CHECKSTMTS Name, F4 for list 

VORSTOM in <ootey eee: ae; toticet cen cetear ene 01_ 01-99 

Reporntadate. cc. .t ene tesa es es 19950331 Date (YYYYMMDD) 

Report sequence number. .... 001_ 001-999 

PRANCER cai eqic wy aneael aoe ay xoutq Name, *OUTQ 

Bottom 

F3=Exit F4=Prompt F5=Refresh F1Q=Additional parameters  F12=Cancel 

F13=How to use this display F24=More keys ) 
Figure 128. Print Report for OnDemand (PRTRPTRDAR) 
If you entered *OUTQ in the Printer field, press Enter to continue to|Figure 129 
ie 

Print Report for OnDemand (PRTRPTRDAR) >) 

Type choices, press Enter. 

Reportname’ & dice eso tar oe: >CHECKSTMTS Name, F4 for list 

VERS OME, seveh ec sce ce cen ecies er cs seme >01__ 01-99 

Report date: 2 2 eww Ge ee >19950331 Date (YYYYMMDD) 

Report sequence number ..... >001__ 001-999 

PRIMO = 45,4 a “ace e a ee >*x0UTQ Name, *OUTQ 

Qutput: queues... 2 ss cet ent ce ee *JOB Name, *JOB 

LeiDRan YS cles eecen so to sice css en ss Name, *LIBL, *CURLIB 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10Q=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys Y 


Figure 129. Print Report for OnDemand (PRTRPTRDAR) 


Press Enter to print. 
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If the print is unsuccessful, the error message (or messages) is written to a report 
with a spooled file name of QPRLRERR. To view this report, select option 8., 
Work with Spooled Files, from the Report DeFiniTion MENu,|Figure 116 on page 71 
Correct the error and run the Print Report option again. 

Option 4. Start Report Management Cycle 


To begin the Report Management Cycle, you can either: 


* Select option 4, Start Report Management Cycle, from the ONDEMAND Report 
Utitiry MENu. 


* Add the STRRMCRDAR command to a Control Language (CL) program 
* Type the STRRMCRDAR command and press F4. 


Figure T0]appears 


ig a 


Start Report Management Cycle (STRRMCRDAR) 
Type choices, press Enter. 
Process to muni swe ke em Gas *ALL *ALL, *MIGRATION, *EXPIRATION 
Report policy «=. 2 << % *ALL Name, generic, *ALL... 
Log migration status...... *NO *NO, *YES 
Send failure message. ..... *NO *NO, *YES 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 130. Start Report Management Cycle (STRRMCRDAR) 


Press Enter to begin the cycle, or F10 to verify or change fields for Submit to batch, 
and Job description and Library. If you entered *YES in the Send failure message field, 
another field appears; enter the name of the message queue to which OnDemand 
can send the message. 


A statistics report with details of the Report Management Cycle activities will be 
generated each time this process is run. 


Option 5. Start Monitor Output Queue 


The monitor continually checks an output queue for spooled output, and allows 
OnDemand to capture the spooled files as they arrive. 


We recommend using the monitor program in a batch environment only. 


You generally define and manually store reports with a command or menu option 
during testing. When the report is ready for production, you can automate storage 
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with the OnDemand Monitor—if you use the *SPLFNAME, *FORMTYPE, or 
*USERDATA spooled file attribute of the report to match the report name you 
entered in the report definition. 


The spooled files must be in ready status (RDY) on the output queue that you are 
monitoring. 


The first time a Monitor is started for an output queue, OnDemand will create a 
data queue and attach it to the output queue being monitored. If there are spooled 
files already in that queue, the monitor will not detect them. If this happens, place 
these spooled files on hold, then release them. The Monitor should then detect and 
process them. This should only be necessary the first time a Monitor job is started 
for a particular output queue. 


To begin capturing reports automatically when a spooled file arrives in a particular 
output queue, select option 5, Start Monitor Output Queue, from the ONDEMAND 
Report Utiity MENu. (You can also issue the STRMONRDAR command.) 


Figure 261] appears 


( Start Monitor for OnDemand (STRMONRDAR) * 
Type choices, press Enter. 
Quitpui queue sais ee fo wee ste a MYOUTQ____ Name 
[SID alley ecneeg cue rca sae eter cue tame *LIBL Name, *LIBL, *CURLIB 
Value to use as report name: 
Check tirsti< soi) settee a elas *SPLFNAME *SPLFNAME, *FORMTYPE... 
Checkonexts sey seis es en sens *NONE_ *NONE, *FORMTYPE... 
Gheek: Wasiti Sess cou keees voce tos te *NONE *NONE, *USERDATA... 
VERSHONiarte raion arcana ae iacetomr is *HIGHEST_ 01-99, *HIGHEST 
Error output queue... 5 . = ERROR Name 
Llib aleve es col cleo rere coe QUSRRDARS_ Name, *LIBL, *CURLIB 
Delete processed spooled files . ¥*NO *NO, *YES 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10Q=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 131. Start Monitor for OnDemand (STRMONRDAR) 


If you entered *YES for Delete processed spooled files, you can press Enter to start the 
monitor or_press F10 for additional parameters. The additional parameters are 
shown in [Figure 133 on page 85)and |Figure 134 on page 86 

If you entered *NO for Delete processed spooled files, two other fields appear, as 
shown in |Figure 132 on page 85 
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Start Monitor for OnDemand (STRMONRDAR) 

Type choices, press Enter. 
Output: queues... sr ee ee >MYOUTQ___ Name 

LED aC Vaaesemrettc aren cseee ct smpemt sa *LIBL__ ~~ Name, *LIBL, *CURLIB 
Value to use as report name: 

CheckatiicS tears mers cece sees *SPLFNAME_ *SPLFNAME, *FORMTYPE... 

Gheckanexitc cence pears pe ences. *NONE. *NONE, *FORMTYPE... 

Checks asit=.y scree) verse since cours *NONE. *NONE, *USERDATA... 
VEVSTOM, eect on cursors? oe anise orcas *HIGHEST__ 01-99, *HIGHEST 
Error output queue....... ERROR Name 

Leib rent yi Ae sckss ne oy suse cues ass QUSRRDARS_ Name, *LIBL, *CURLIB 
Delete processed spooled files . *NO *NO, *YES 
Processed output queue..... PROCESSED _ Name 

Eta Yio errucae? se, eines tieuso estes QUSRRDARS_ Name, *LIBL 

Bottom 

F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 132. Start Monitor for OnDemand (STRMONRDAR) 


Press Enter to start the monitor, or press F10 for additional parameters as shown in 
Figure 133]and |Figure 134 on page 86 


Ve 
Start Monitor for OnDemand (STRMONRDAR) +) 


Type choices, press Enter. 


Quit puaqueuer. sires scuxey veces suc >MYOUTQ___ Name 

leID Raia teutauvomsrrceasetrnicena: caus *LIBL Name, *LIBL, *CURLIB 
Value to use as report name: 

Ghecksivits tear smes wcprcrss susan sie: *SPLFNAME_ *SPLFNAME, *FORMTYPE... 

Checksmexitieets cemrcucy seit es erence *NONE. *NONE, *FORMTYPE... 

Check. lasits:, crs. e se. eet *NONE. *NONE, *USERDATA... 
VEVSTONmysrscneeo nse ceatcnte ees suucomsihce *HIGHEST__ 01-99, *HIGHEST 
Error output queue. 4%. <6 ss ERROR Name 

[sib rary Gs: sp asuesh is ents: conten QUSRRDARS_ Name, *LIBL, *CURLIB 
Delete processed spooled files . *NO_ *NO, *YES 
Processed output queue..... PROCESSED _ Name 

TDR AY sob a len neocon ce wh ceo. eu QUSRRDARS_ Name, *LIBL 


Additional Parameters 


Endisdatemsit caus esa scence ena * NONE. Date (YYYYMMDD), *NONE, ... 

More... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 133. Start Monitor for OnDemand (STRMONRDAR) - Additional Parameters 


Press Page Down for the second parameter screen,|Figure 134 on page 86 
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(e ~ 


Start Monitor for OnDemand (STRMONRDAR) 


Type choices, press Enter. 


eimestorendi: ce. (05 Fee ce oc eee 235500___ Time 
CRECKINTENVGl< & s:6 4 «ww x 90 Seconds, *IMMED 
Number of monitors to start .. I__ 1-99 
Submit: to: batch «2. 5 6 ws *YES *NO, *YES 
VODSACESCH IPE TON 5 he ces ce Gs. soe QRDARS400_ Name 
EDGAR Viiaccreneeconsiec aterm. treats *LIBL Name, *LIBL, *CURLIB 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 134. Start Monitor for OnDemand (STRMONRDAR) - Additional Parameters 


Press Enter to start the monitor. 


The monitor runs continuously until the End date or End time occurs. You can also 
use |“Option 6. End Monitor Output Queue”|to stop processing. 
The monitor processes any spooled files that arrive in the named output queue in 


RDY (Ready) status. Spooled files with any other status are not affected by the 
monitor, and remain in the output queue until they are deleted or moved. 


Option 6. End Monitor Output Queue 


If you do not indicate an End date and a Time to end when you started the monitor, 
you must use this option to end the output queue monitor. Select option 6, End 
Monitor Output Queue, from the ONDEMAND Report Utitity Menu. (You can also 


issue the ENDMONRDAR command.) |Figure 135 on page 87| appears. 
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End Monitor for OnDemand (ENDMONRDAR) 


Type choices, press Enter. 


Output: queues. 2s a ye ae MYOUTQ Name 
EVDWaNy 3s. 98 ease tet ee oe ae *LIBL Name, *LIBL, *CURLIB 
Number of monitors to end ...  *ONE *ONE, *ALL 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
XS 


Figure 135. End Monitor for OnDemand (ENDMONRDAR) 


Press Enter to end the monitor or monitors. 
The monitor stops when the number of seconds you entered in the Check Interval 
field (“Option 5. Start Monitor Output Queue” on page 83) is reached. 
Option 22. OnDemand Main Menu 
Use this option to return to the OnDemand Main Menu, 


Option 30. Change OnDemand Global Report Options 


Reports that have been stored in OnDemand are retrieved by various users, and 
then these retrieved reports are viewed, reprinted, or faxed. These three output 
operations are controlled by various customization values (either global or 
individual user) which are kept in OnDemand data areas. Setting these values is 
done easily using the screens that follow. 


Global customization options are used as defaults when an individual user has no 
setting defined for his own user profile control values. (See 
Your OnDemand Report Options” on page 89]and 
for details on individual user settings.) The individual 
user’s controls always have higher priority. For example, if a user’s CA/400 Viewer 
control value is set to *BOTH and the global default is set to *NO, that particular 


user will use the CA/400 Viewer to view both AFPDS and non-AFPDS spooled 
files. 


To change the global default customization options, choose option 30, Change 
OnDemand Global Report Options, to move to|Figure 136 on page 88 
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(~ Select Global Section to Change ONDMD400 > 
1/04/98 14:27:53 
Type selection, press Enter. 
1=Select 
Choose Section 
Viewer Options 
Combination Options 
F3=Exit F12=Cancel 
/ 
Figure 136. Select Global Section to Change 
Enter 1 beside the category of global customization defaults you wish to change. 
Press Enter to save the changes. 
Viewer Options 
If you select the Viewer Options category, you will continue to This 
screen gives you a choice of global viewer options. 
(~ Change Global - Viewer Options ONDMD400 > 
1/04/98 14:27:53 
Type choices, press Enter. 
Use CA/400 Client viewer. ....... *NO, *AFPDS, 
*BOTH 
Use enhanced 5250 viewer. ....... *NO, *YES 
Use viewer exit program ........ Name, *DEFAULT... 
Ist ainey’mact ne onceaktalee. isn te ciemeeocna wy rome 
Use OnDemand Client .........2. *NO *DEFAULT, *NO, 
*YES 
F3=Exit F12=Cancel 
ey 


Figure 137. Change Global - Viewer Options 


88 IBM Content Manager OnDemand for iSeries: Administration Guide 


Combination Options 


If you selected Combination Options from the initial screen, then OnDemand 


presents 


ie 
Change Global - Combination Options ONDMD400 +) 
1/04/98 14:27:53 
Type choices, press Enter. 
Combine all multiple requests ..... *NO, *YES 
Combine multiple view requests ..... *NO, *YES 
Combine multiple print requests .... *NO, *YES 
Combine multiple fax requests ..... *NO, *YES 
F3=Exit F12=Cancel 
y 


Figure 138. Change Global - Combination Options 


Option 31. Change Your OnDemand Report Options 


Each user of OnDemand identified by a unique user profile has an OnDemand user 
defaults profile. If an individual user has no setting defined for his own user profile 
[Option 


control values, the global customization options are used as defaults. (See 
30. Change OnDemand Global Report Options” on page 87| for details on setting 


the global options.) 


To change the customization options for your own user profile, choose option 31, 
Change Your OnDemand Report Options, to move to|Figure 139 on page 90 
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(~ Select Profile Section to Change ONDMD400 > 
1/04/98 14:27:53 
OnDemand user profile... .. :  NOBRIEN 
Type selection, press Enter. 


1=Select 


Choose Section 
Print 
Fax 
Bypass Options 
Viewer Options 
Combination Options 


F3=Exit F12=Cancel 


Figure 139. Select Profile Section to Change 


Enter 1 beside the category of customization options you wish to change. 


Print Options 


If you select the Print category, you will continue to|Figure 140] This screen gives 


you a choice of print options. 


{(e 
Print Options ONDMD400 i 
1/04/98 15:39:09 
OnDemand user profile ........ .. : NOBRIEN 
Type choices, press Enter. 
Prainten name: < Aoss0.08 3. oS PRTO1 Name 
-OR- 
Output-queue: ce ie Name 
iDRaRY: cetaceans Sees *LIBL Name, *LIBL, *CURLIB 
Number of copies ...... oe 1-999 
Page range: 
Starting page. «. 3. % « 1 1-9999999999 
Ending: page: : ais. 4 4 *END 1-999999999 
Use report overlay ..... *NO_ *YES, *NO 
F3=Exit F12=Cancel 
4 


Figure 140. Print Options 


Press Enter to save the values. 
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Fax Options 
If you selected Fax, use this screen,|Figure 141} to set your fax customization 


options. 
( Fax Options ONDMD400 *) 
1/04/98 15:13:12 
OnDemand user profile. ........ . : NOBRIEN 
Type choices, press Enter. 
Outgoing Fax number. ...... 
Goverspages on v1 fe bos), er sd vee *YES *YES, *NO 
MACHOs 5-10 Rees ws sie Ge en ea ee sue 
Syaleleatolee terre: aut creed re car 
SOM CMD Va ance ate comes cers comer comer 
Comment. Vine) esis 4 ve) ek ee 
Bax imode: tn sce ep er eo fen een eo eau *NORMAL *NORMAL, *FINE 
Number:of Copies: 20. 55 ea a 1-999 
Page range: 
Starting pages...) 2 sk a a 1-99999999999 
Endiingitpage war.) cptces su tessa os 1-99999999999, *END 
Use report overlay ....... *NO_ *YES, *NO 
F3=Exit F12=Cancel 
y 
Figure 141. Fax Options 
Press Enter to save the values. 
Bypass Options 
If you selected Bypass Options, OnDemand displays |Figure 142 
(— ; + 
Change Profile - Bypass Options ONDMD400 
1/04/98 14:27:53 
OnDemand user profile ......... . : NOBRIEN 
Type choices, press Enter. 
Bypass prompt for print/fax ...... *USERRESP, *BYPASS 
Bypass prompt for tape recall ..... *USERRESP, *BYPASS, 
*NOTIFY 
F3=Exit F12=Cancel 
S 
Figure 142. Change Profile - Bypass Options 
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Viewer Options 


If you selected Viewer Options from the initial screen, then you will work with the 


screen in 


( Change Profile - Viewer Options ONDMD400 >) 
1/04/98 14:27:53 
OnDemand user profile ......... . : NOBRIEN 
Type choices, press Enter. 
Use CA/400 Client viewer. ....... *DEFAULT, *NO, 
*AFPDS, *BOTH 
Use enhanced 5250 viewer. ....... *DEFAULT, *NO, 
*YES 
Use viewer exit program ........ Name, *DEFAULT... 
EVD Va eVieteae cores caver ce ce lveoncurcansarrareas 
Use: OnBemand Client « <4. 2 <5 «= @ « « *DEFAULT__ *DEFAULT, *NO, 
*YES 


F3=Exit F12=Cancel 


oy 
Figure 143. Change Profile - Viewer Options 
Combination Options 
If you selected Combination Options from the initial screen, then OnDemand 
presents |Figure 144 
“as 
Change Profile - Combination Options ONDMD400 >) 
1/04/98 14:27:53 
OnDemand user profile ......... . : NOBRIEN 
Type choices, press Enter. 
Combine all multiple requests ..... *DEFAULT, *NO, 
*YES 
Combine multiple view requests ..... *DEFAULT, *NO, 
*YES 
Combine multiple print requests .... *DEFAULT, *NO, 
*YES 
Combine multiple fax requests ..... *DEFAULT, *NO, 
*YES 


F3=Exit F12=Cancel 


Figure 144. Change Profile - Combination Options 


Press Enter to save the changes. 
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Option 32. Change OnDemand Report Options 


To change the customization options for a user profile other than your own, choose 
option 32, Change OnDemand Report Options. Enter the specific user profile with 
which you want to work (enclosed in single quotation marks) on the screen that 


appears and press Enter. The screens that follow are exactly as those described in 
“Option 31. Change Your OnDemand Report Options” on page 89 
Option 40. Report Definition Export/Import 


The report definition export and import feature provides the capability to copy 
report definition records from one R/DARS or OnDemand system to another. 


Export refers to the process of copying selected report definition records from an 
existing R/DARS or OnDemand for iSeries installation into a separate "transfer" 
file. 


The system transfers the report definition records in this transfer file from the 
"source” system to a "target" system. The target system must have R/DARS or 
OnDemand installed. 


Note: The version of R/DARS or OnDemand must be V3R7 or later. 


The “import” process adds these report definition records to the standard report 
definition file (QARLRACT) on the target system. The process also performs 
additional functions as required to make sure that added or "imported" report 
definitions will work correctly on the target system. Error checking provides 
guidance for the user and prevents interference with existing functions on the 
target system. 


This description of the export/import feature applies only to OnDemand for 
AS/400® V4R5 and subsequent releases. The export/import capability for earlier 
versions and releases has different operator interfaces. You can find the 
documentation for those earlier versions in the text member "RDEIINSTR" in the 
library /file QRDARS/QSAMPLES. 


There are four main parts or functions within the export/import process: 


1. Copy selected report definition records from the OnDemand standard report 
definition file (QARLRACT) on the source system into a transfer file. The report 
definition transfer file created has the same file attributes (record format, access 
path, and so forth) as the original QARLRACT file. You can use any method to 
select and copy the records that are copied into the transfer file. The 
CPYDFNRDAR OPTION(*EXPORT) command creates this file and copies 
records into it based on the values of report definition name, version, and 
group name. This command creates the report definition transfer file the first 
time it is run for a particular file name. The command also adds copied records 
to that same file in subsequent runs with the same file name. If logical view 
support is being used on the source system, CPYDFNRDAR 
OPTION(*EXPORT) makes a copy of all of the logical view records in the 
QUSRRDARS/QARLRAPP file. You must move this "logical views transfer” file 
to the target system along with the report definition transfer file. If the 
folder-field file that is used by the OnDemand Client/Server is also used on the 
source system, CPYDFNRDAR OPTION(*EXPORT) makes a copy of all of the 
folder-field records in the QUSRRDARS/QARLRFFU file. You must move this 
"folder-fields transfer" file to the target system along with the report definition 
transfer file. 
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2. Run the CPYDFNRDAR OPTION(*PRINT) command to list the records 
copied into the transfer file. The command will list the report definition records 
in report name and version sequence. The records are identified by report 
name, version, policy, and group name. This list includes the number of records 
in the file and provides additional information about specific "related objects” 
that are associated with the copied report definitions. 


3. Move the report definition transfer file, and the optional files of logical view 
records and folder-field records, if created, from the source system to the target 
system. You can do this by using any convenient method available. Note that 
you can create the transferred files on any of the supported versions of 
R/DARS or OnDemand. Once created, you can transfer the files to a target 
system having any of the supported versions. 


4. Run the command CPYDFNRDAR OPTION(*IMPORT) on the target system. 
This will copy all of the report definition records in the report definition 
transfer file into the standard report definition file 
(QUSRRDARS/QARLRACT). This enables the file for use by the OnDemand 
programs of the target system. This import process notifies the user of errors 
which prevent processing the transfer file. Also, for each one of the transferred 
report definitions, it checks for error conditions which prohibit copying that 
particular report definition. An "error list" spooled file lists these errors. The 
system produces a list only when it finds at least one such error. Separate 
spooled files list the report definitions that import successfully into the 
R/DARS or OnDemand files on the target system. This imported list may also 
show various warnings for each imported report definition. These "warnings" 
include the names of "related objects” which are named in the imported report 
definition but not located on the target system. The system marks the report 
definition records in the transfer file which import successfully. You can run 
CPYDFNRDAR OPTION(*IMPORT) command to process the records that 
were not imported because of error conditions which have since been corrected. 
The program skips over the report definitions that previously imported 
successfully. Each of the processing steps described above has a set of very 
detailed instructions in each of the numbered sections (1-4) which follow. Each 
of these sections covers the following information: 


* Explains any required preparations. 
* Describes how to specify the parameter values when running the command. 
* Provides information about error checking. 


* Describes how to re-run the step if necessary. 


Step 1. Exporting Report Definitions on the Source System 


First, copy selected report definition records from the OnDemand standard report 
definition file (QARLRACT) on the source system into a transfer file: 


1. Make sure that you know which report definition records are to be copied to 
the report definition transfer file. 


2. Run the export copy command CPYDFNRDAR OPTION(*EXPORT): 


CPYDFNRDAR OPTION(*EXPORT) 
RPTDFNFILE(transfer-file/library) 
VIEWFILE(view-file) 
FLRFLDFILE(folder-field-file) 
REPORT(report-name) 
VERSION (version) 
RPTGRP(group-name) 
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Include each of these parameters when the first parameter (OPTION) is 
*EXPORT. The parameters RPTDFNFILE(transfer-file/library), 
VIEWFILE(view-file), and FLRFLDFILE(folder-field-file) are used to identify 
the following items: 


* Report definition transfer file. 
* The associated library. 


* The optional transfer files for logical view records and folder-field records, if 
needed. 


Use the parameters REPORT(report-name), VERSION(version), and 
RPTGRP(group-name) to select the report definition records that you want to 
copy into the report definition transfer file. The following list describes the 
specific values for each of these parameters: 


OPTION *EXPORT = Copy report definition records 
from the standard report definition file 
(QARLRACT) into the file named in the 
RPTDFNFILE parameter. 

RPTDFNFILE “transfer-file’ = name of the report definition 
transfer file which will contain the copied or 
exported report definition records. The first 
character of this file name cannot be "Q”. 
This parameter cannot be left blank. ‘library’ 
= name of the library where the transfer file 
exists or is to be created. "*CURLIB” may be 
used. If the ’transfer-file’ named exists, the 
existing file will be used, and the selected 
report definition records will be added to 
those records already in the file. If the 
transfer-file’ named does not exist, a new file 
will be created. 

VIEWFILE ’view-file’ = name of the file which will 
contain the logical view records from the file 
QARLRAPP. This file name is required only 
if logical view records actually exist. 
‘view-file’ = *NONE is permitted if there are 
no logical view records to be copied during 
the export process. The logical-view transfer 
file must be in the library that was specified 
for the report definitions transfer file. 

FLRFLDFILE ’folder-field-file’ = name of the file which 
will contain the folder-field records from the 
file QARLRFFU. This file name is required 
only if folder-field records actually exist. 
‘folder-field-file’ = "*NONE” is permitted if 
there are no folder-field records to be copied 
during the export process. The folder-field 
transfer file must be in the library that was 
specified for the report definitions transfer 
file. 
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REPORT ‘report-name’ = "*ALL” means copy all of the 
report definition records in the QARLRACT 
file into the report definition transfer file. 
‘report-name’ = "XX...X" means copy report 
definitions which have a report name which 
exactly matches the entered characters, where 
"XX...X" = 1 to 10 uppercase characters. 
‘report-name’ = "XX...X*" means copy report 
definitions which have a report name which 
starts with the entered characters, where 
"XX...X" = 1 to 9 uppercase characters. For 
example, entering "AB*” would copy report 
names "ABC" and "ABO001”" in addition to 
"AB". ‘report-name’ = "" means the report 
name is not used to select report definition 
records. 

VERSION ‘version’ = "NN" means copy all report 
definition records which have version = 
"NN", where "NN" can be any two-digit 
number, "01" through "99". ‘version’ = "" 
means the report version is not used to select 
report definition records. 

RPTGRP ‘group-name’ = "XX...X" means copy report 
definition records having a report group 
name equal to the entered characters, with 
"XX...X" = 1 to 10 uppercase characters. 
‘group-name’ = """ means the report group 
name is not used to select report definition 
records. 


The last three parameters cannot all be blank. If the REPORT value is "*ALL", 
both the VERSION and RPTGRP parameter values must be blank. If you enter 
both REPORT and RPTGRP values, the REPORT value must be generic, that is, 
it must end with "*". If you use two or three of these last three parameters 
concurrently, the report definition records that you want to export must match 
all of the entered values. 

3. Error checking for this step consists primarily of running the next step to list all 
of the report definition records copied into the report definition transfer file. 
Careful correlation of the records listed from the transfer file with those in your 
export/import plan is essential. 


4. You can run the CPYDFNRDAR OPTION(*EXPORT) command as many times 
as needed to copy all of the report definition records that you want to export. 


Note: Copying more report definitions of the same name and version into an 
existing report definition transfer file may replace previously copied 
records in the transfer file. The CPYF command that is initiated by the 
CPYDFNRDAR OPTION(*EXPORT) command uses 
MBROPT(*UPDADD) to copy records into a report definition transfer 
file. This command will copy records that existed before you ran the 
command. You should copy all of the report definition records that you 
want to export into the transfer file before you update any records in the 
transfer file. 


Step 2. Listing Report Definitions in the Transfer File 


1. No preparation is necessary other than having run the previous step to copy 
some report definition records into the report definition transfer file. 
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2. Run the "copy to printer” command CPYDFNRDAR OPTION(*PRINT): 


CPYDFNRDAR OPTION(*PRINT) 
RPTDFNFILE(transfer-file/library) 


The following list describes the specific values for each of these parameters: 


OPTION *PRINT = print a summary list of the report 
definition records from the file named in the 
RPTDFNFILE parameter. 

RPTDFNFILE ‘transfer-file’ = name of the report definition 
transfer file which contains the copied or 
exported report definition records to be 
listed. This parameter cannot be left blank. 
‘library’ = name of the library where the 
transfer file exists. The special value 
"*CURLIB” may be used. 


Note: It is possible to run CPYDFNRDAR OPTION(*PRINT) and specify the 
standard OnDemand report definition file (QUSRRDARS/QARLRACT). 
This may provide useful information when planning the export and 
import of report definitions. 


3. Error checking for this step consists only of reading the report produced. The 
number of records that are read from the transfer file appears at the bottom. 
Careful correlation of the records listed with those in your export/import plan 
is essential. The "warning" information provided alerts you to special 
requirements. The special requirements include "related objects” that are named 
in the transferred report definitions which may not exist on the target system. 
Note that the export or import programs do not process or copy these "related 
objects”. 

4. You can run the CPYDFNRDAR OPTION(*PRINT) command as many times 
as needed. You can use two methods to distinguish between multiple copies of 
the report: 


* The run date and time that is indicated in the report heading. 
* The transfer file and library that is listed in the bottom summary line. 


Step 3. Moving the Transfer Files to the Target System 


Move the report definition transfer file, and the optional files of logical view 
records and folder-field records, if created, from the source system to the target 
system. You can do this by using any convenient method, such as magnetic media, 
FTP, and so forth. 


Step 4. Importing Report Definitions on the Target System 
1. Run the "import copy” command CPYDFNRDAR OPTION(*IMPORT): 
CPYDFNRDAR OPTION(*IMPORT) 

RPTDFNFILE(transfer-file/library) 


VIEWFILE(view-file) 
FLRFLDFILE(folder-field-file) 
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The following list describes the specific values for each of these parameters: 


OPTION 


RPTDFNFILE 


VIEWFILE 


FLRFLDFILE 


2. Error checking and correction steps: 


*IMPORT = copy report definition records 
from the report definition transfer file named 
in the RPTDFNFILE parameter into the 
standard report definition file for OnDemand 
(QUSRRDARS/QARLRACT). 

‘transfer-file’ = name of the report definition 
transfer file which contains the previously 
copied or exported report definition records. 
The first character of this file name cannot be 
a "Q". This parameter cannot be left blank. 
‘library’ = name of the library where the 
transfer file exists on the target system. 
"*CURLIB” may be used. 

‘view-file’ = name of the file which contains 
the logical view records copied on the source 
system. This file name is required only if 
logical view records actually exist in such a 
file and they are to be copied on the target 
system. ‘view-file’ = "*NONE" is permitted if 
there are no logical view records to be copied 
or if you wish to omit copying them during 
import processing. This logical-view transfer 
file must be in the library that was specified 
for the report definitions transfer file. 
’folder-field-file’ = name of the file which 
contains the folder-field records which were 
copied on the source system. This file name 
is required only if folder-field records 
actually exist in such a transfer file and they 
are to be copied onto the target system. 
‘folder-field-file’ = "*NONE" is permitted if 
there are no folder-field records to be copied 
or if you wish to omit copying them during 
import processing. The folder-field transfer 
file must be in the same library that was 
specified for the report definitions transfer 
file. 


a. If the command or program displays an error message instead of processing 
the transfer file, correct the error condition described in the displayed 
message and run the command again. 


b. The commands or programs that find error conditions which prevent 
copying a report definition will list these errors in an "error list” spooled 
file. The system produces this file only if it finds at least one such error. At 
least one of these reasons why a report definition record was not imported 


will be listed: 


1) Report name and version are duplicates of an existing record; 


2) Group assignment does not match that in an existing record having the 
same report name (field CDTYPE); 


3) Group name specified in the report definition does not exist as a report 


group definition; 


4) The policy (collection) that is named in the report definition record does 


not exist; 
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5) The system could not find the printer file that is named in the report 
definition record; 


6) The system encountered an unusual problem while attempting to import 
a report definition record. The system will specify the file add or update 
error in the printed error text. 


Separate spooled files list report definitions that import successfully into the 
OnDemand files of the target system. This "imported list” also lists various 
"warnings” for each imported report definition. These "Warnings” include 
the names of specified "related objects” that are in the report definition but 
not located on the target system. Do not ignore these "import warnings”; 


most of them point to potential error conditions which will prevent 
successful use of the imported report definition record. 
3. You can run the CPYDFNRDAR OPTION(*IMPORT) command as many 
times as needed to import all of the report definition records in the report 


definition transfer file. The command marks the report definition records in the 


transfer file that import successfully. You can run the command again to 


process any records that were not imported because of error conditions which 
have since been corrected. The import program skips over the report definitions 
that previously imported successfully. For example, assume that a transfer file 


contains 215 report definition records and that 205 of these records imported 


successfully during the first run of CPYDFNRDAR OPTION(*IMPORT). The 
second run would show that it read only 10 records from the report definition 


transfer file. 


Report Definition - Environment Work Sheet 
NOTE: Some fields and their descriptions will appear or have slightly different 


wording under certain conditions. 


Va 
Report Definition - Environment ONDMD400 ) 
1/08/98 14:49:43 
Type choices, press Enter. 
REDON Caemem toner ttem cum san su mec anoint, Brits unc ea's ame 
VORSTOMi eis) syesng ease bseres sone te yee eu sae Fembot ts’ cs i 01-99 
REPOPGULYPEs sce sacs Ae ie Ae fos et ces cot van eeiret tear ies ve DOC, PAGE 
ODX, UBND 
linput: mecord’: length’. ceaceur. cw ve te, eecee sn ce — 20-256 
POG YAMANE: oeere cr Rie, oe ere tesa neu ese ret especure eae ame 
Reportroverlay!. cy cet sc. ts. ashes ea sd oe te ees ame 
Report data type ss Sa we eS es *SCS, *AFPDS 
*OTHER... 
REDORG GROUP: une sarees se arenes ter 447 vemos uere ee ame 
Translatesprint control. oS so <i ee SNe en ee = Y=Yes, N=No 
Pretinbenstilieots wecpescns. cp ucts tater cw oureksoe en oxi ys ame 
ETD asain oeaeen, ca vere m cea sure we cog operas aco aes anaes 
UNSb Giscieas = Geeaurce wet ume Be eae here eet MC Roh ernten eo: Fone 
GOMPRESSHOMN cays .ce oe cele pen eem che ts bomen aca votes me Y=Yes, N=No 
Posting) datertype: vce 2. lee Gen ceca ere tetices telus = 
More... 
F3=Exit F12=Cancel 
y 
Figure 145. Report Definition - Environment Worksheet (1 of 3) 
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fe 


Report Definition - Environment 
Type choices, press Enter. 


Posting date: 


F3=Exit F12=Cancel 


\ 


ONDMD400 


1/08/98 14:50:49 


WV0@ 6 ew Se swe wl we eS eee Se we, Hs ss 

MQM GE hice ce zea ltet Gaicestes ten <coetse <a) ere en oo eevee ry 0-25 

CON UMIMT cece ce eM ede raees er sates oe tor roqeed Pon ese teas is 0-255 

[Us Witches araueee Speed ears cch en ECR econ Ce POnerr RR OC oF 0-256 

-OR- 

PAW OR Va UGS ie 25. coe: ce cater ven Fog cores Ceacsuu sucess 
Eemgtlice: 2c se: kehos ney Geman tee toe conse se er cone ee ey = 1-16 
CONUMM meses atric en eters ecm ne omc ogee ed 0-255 
PSHM MOZOTTSORS (0c en ca2 er ten cae vores vor teas) tees -255-256 


More... 


Figure 146. Report Definition - Environment Worksheet (2 of 3) 


ja 


Report Definition - Environment 
Type choices, press Enter. 


Bypass report results display ........ 
Bypass document results display ....... 
Search all sequence numbers ......... 
IMpUt XT a os ee et Gi Oe se 

[etlo yt Wik eereeaerie Ausra ce areca mre reearetaea e errakriee *LIBL 
TMASXROXG Eee sere ccak eter weirs) emo ccs? see means 

IETIDNARYs cers, Behe. e eh cer ce So cee snes wh ves ewes *LIBL 
Wnbundile-rexiits eyo csc tag) sce ce. eel vou ce ansene) ceca bees 

EVD Ya Viter mecemeits ie tan cinrete: Meca Vesna ccer can aa i *LIBL 


F3=Exit F12=Cancel 


ONDMD400 


1/08/98 14:51:26 


Y=Yes, N=No 
Y=Yes, N=No 
Y=Yes, N=No 
Name 
Name 


Name 


Bottom 


Figure 147. Report Definition - Environment Worksheet (3 of 3) 
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Report Definition - Segmentation Work Sheet 


(— ae : >) 
Report Definition - Segmentation ONDMD400 
1/08/98 14:51:39 
Report /Verstony vec vals evs cee: an tenes 3s i 
Type choices, press Enter. 
SEOMENGeESI ZOU sehr seccayenres et iee eae et — 1-100 
Segmentation condition 1: 
Change/Match 2.5 a 64 2% Se 1=Change, 2=Match 
Vala tene Reet sivas erect es cae salwar suas 
LU (Teel We ceiecrenaee cesuciecRen ete eCamunce Caet = 0-25 
Goi Uninaie cers aes esate cme aes eencwrey (oes 0-255 
FUNG Sar eee set rsereahea cat tue) famecabas ete: care en 0-256 
-OR- 
PaO Walley tense: oe as bow ceat eae 
Beng ties: sauce uns ese) career eludes e 0-16 
GOIUMM Aes eters cy: Reo as: ehyrsc cee eats, as a 0-255 
Tow lNGcO SCC musmrtiemtan Ag sak cage es — -255-256 
Condition combination . «4 « « « « O=None, 1=And, 2=0r 
More... 
F3=Exit F12=Cancel 
/ 
Figure 148. Report Definition - Segmentation Worksheet (1 of 2) 
ie 
Report Definition - Segmentation ONDMD400 +) 
1/08/98 14:52:15 
Report /Venstonite se .tasg tey os) Coens paceatre es je 
Type choices, press Enter. 
Segmentation condition 2: 
Change/Matchima a9 Gos, ss fans os onc 1=Change, 2=Match 
Valet 2s SS. So ise Ge ie een a eos 
Length’ sols) cites tenance es erute Gey eee = 0-25 
COMUMME Fea eei er 2) der ser co; Coe rose uae 0-255 
UN oho ace cee ane co serch CS erRaC erp ectiy eC ae 0-256 
-OR- 
PaOre: VarliUGies eee se a: ete ess coc rates eso 
WONG ENS ee cee corpses es sees ensue pecs = 0-16 
CO UMM Mea steam ier ate tie «Monette ats —_ 0-255 
A= NAMNEZOTESCL. os ys2 es ces: eos ey oo = -255-256 
Bottom 
F3=Exit F12=Cancel 
y 


Figure 149. Report Definition - Segmentation Worksheet (2 of 2) 
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Report Definition - Keys Work Sheets 


a Report Definition - Keys ONDMD400 
1/08/98 14:52:24 
REPORt/ VERSION) csace re sae ce sete os euuac es. os 
Type choices, press Enter. 
Keyed names “se sco tcs wc) tiaras emesv ase to delace sh ovis 
MEGNG.t Ny eierrey ce: memes srecmcaescn ten chcwarercreh weasel ce it 1-25 
Minimum search characters ......... _ 1-length 
Location: 
kGfoll VU lth, ater eecents Neath Mocca Cetreecc. es yet) ok _ 0-255 
STING. ees ves ciozacss wer Pezces aly ver es Ge hes ees cou ceites Yeore = 0-256 
-OR- 
Pivot: Valuer. 22s eas ee ee we 
Eengtiiigvenc pes kt cotviarrar cece elem incerta am 0-16 
COMUMMPets reteietee swe sse ey dane etes cour nen te = 0-255 
T= WNGGOMRS EL: ssc he to ve: eee: eee as Ws par -255-256 
owereCaSenkey: oesersales roast: nev weuscotscnss te coy ee Y=Yes, N=No 
Key <SCGUNI CY 5 <ve ss eo ens tren escecn ose Y=Yes, N=No 
MUI ET key canG rane Sc teecutn, (uate ew cot, arn ks Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 
Figure 150. Report Definition - Keys Worksheet (1 of 5) 
Ga nee 
Report Definition - Keys ONDMD400 
1/08/98 14:53:00 
REPORE/VEVS TON eoapverss ttre mey ke detec: eo eteaas = 
Type choices, press Enter. 
KEV c2anAMe pees tsctere certs oscuro st heme saarenrsaketo sete 
IRGNGit Npaeaye mercy Ace mete etre er at errant eats 2 1-20 
Minimum search characters ......... = 1-length 
Location: 
CO! UMM) heise tabu ger res fee re coe couse tomes ten th dene = 0-255 
DTG repress ueem ce arcane Rec aitcur strate peneccul te Ure om 0-256 
-OR- 
Pavotevia lUGisc, cs ssc ot ea ce sos co se teaney er oe Ven e 
eng iter acoder ne ecoks-Weeies Peostangwseccren orice ms 0-16 
CONUMM ens ect aeeirer ee ree canst at cramer ane hts = 0-255 
Aa IINE OT RSC ce: eure ser occ sce ens tee te =_ -255-256 
Eowerscase key coe spiky ie fee ate oe ts eos Y=Yes, N=No 
Key OSCCULTEY: Mitts cst ee ve fone Saco oy ee ve Bente Y=Yes, N=No 
MUM ETEK V4 cocuncatetisatiecltoo te reutoen cance can teuels Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 


Figure 151. Report Definition - Keys Worksheet (2 of 5) 
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a 
Report Definition - Keys ONDMD400 3) 
1/08/98 14:53:28 
Report/Verstoni ai. i an oss oe we we ee a 
Type choices, press Enter. 
Key oS MaMO ma, cer cz coped cr sen es ery sp aeece a eres iene 
Bengithe ca. ney cares votre es Yemecn sea uuee Poueda'ss heals 1-20 
Minimum search characters ......... 1-length 
Location: 
COL UNM: Mosse tauts va opks mcten ten Reaesnees pean sal cye case 0-255 
DIN GSEetrae ee newb nce pice thet aacae sh esa ast eh ees 0-256 
-OR- 
PaVviotavar lies see sc tes on nee eeuier Moo sane cease 
EGHG tM ettater items teestem eh ac ste neers 0-16 
COMUMMinecsnsestcrscmesy elt nocm cae ete aise os aren: 0-255 
he VAINGSONTSEE: se. os, ah eee eS aw ce ve -255-256 
Lowercase: key stoicycs) & veiten a cer st eos le ee Y=Yes, N=No 
Key S@CUrIty <. 4-6. ¢ we ee es we Y=Yes, N=No 
MUI TSIKeyarorierets muvscctn carremeeecn cy rrmccawcenrens Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 
/ 
Figure 152. Report Definition - Keys Worksheet (3 of 5) 
He 
Report Definition - Keys ONDMD400 =) 
1/08/98 14:53:42 
Report /Vensione yccMeo a, <1 te) ones sain en et econ: ae 
Type choices, press Enter. 
GWA AINE S eter ei tess tows nes ew ae cower nee 
engiheeeees.ceue aca sveca leas nc ane eon ec any a 1-20 
Minimum search characters ......... 1-length 
Location: 
C Ol UMM) torres ones tcsrea ccs semen ea ot yee pou stun Rees 0-255 
DSN? ee a RP ep ver Gee eed ens we eee ee os 0-256 
-OR- 
PaWVOValiUCue! 8s: 60s tees sc sh ues cul setts 
length: ss so4 sie es ee sw ee ae es 0-16 
COsUMIN yey set tocee ses voles ss Renesl a) ce ss eee 0-255 
Pe cIMNEHORTSEL: cok a cen eee cee ee ewes: Gave es -255-256 
Eower :case@keyo 22 cree: ueicer th erases Sus a) Y=Yes, N=No 
KEY eSCGUPTGY” sy iieep con cases ten een ar yee fue) te eege Y=Yes, N=No 
MUI Ke Varese agete wouesetancoruncens ns cembcmr sum mnresa Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 
\ / 
Figure 153. Report Definition - Keys Worksheet (4 of 5) 
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a ~ 


Report Definition - Keys ONDMD400 
1/08/98 14:54:31 
Report /VersiOn: fs: i ee we we GE ie 
Type choices, press Enter. 
Key 5 mames ces csr ceu ec cor Ss ies “6° et oat Ses ten esuess cs ce 
WONQibhs eure weer tyres wet ete ca en tunes certs Neste s 1-15 
Minimum search characters ......... s 1-length 
Location: 
CO UMM Betsctes uemes teeters: peu eo tsmence, $e gems = 0-255 
VAM Sie as ses carers er ges hoe Mal ese seu erieen cor ues cer “ean — 0-256 
-OR- 
PAO Via UC. Yu cae cor oot. fon ge) sanemhey oer ts tees 
Bemgthiy ac. cs: coh re Bes cite cee cevte tee epee ear = 0-16 
CONUMM Meee siete ese cme cmn en ec rem ater. ox 0-255 
Ho) IMMNE@GONESELS os ve tee eee oe ee es 7 -255-256 
Lowerscase key) tix tyvcjue cece au tow scot es Y=Yes, N=No 
Key Security 2955 5) eee a ee Y=Yes, N=No 
MUMEENEIKG VA eeert on Opoae abel arcana lode eos ee aneur: Y=Yes, N=No 
Bottom 
F3=Exit F12=Cancel 


Figure 154. Create Report Definition - Keys Worksheet (5 of 5) 


Examples of Report Types 
Defining a PAGE Report 


PAGE reports index by value ranges. They start with the lowest value on the first 
page and end with the highest value on the last page of each report segment. They 
support 1-column or 2-column types of reports and can be, for example, general 
ledger transaction listings, warehouse stock listings, and others. 


The dollar-sequence report, TSTSEQ, is explained below. It has detail line items, 
listed in an ascending (sorted) sequence; the items (check amount) never 
re-sequence themselves within the report. 


The spooled file has been copied into a physical file named TSTSEQ in the 
QRDARS library. 


Use |“Option 6. Display Physical File Member” on page 78| to display the physical 


file that contains the TSTSEQ report data,|Figure 155 on page 105 
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Display Physical File Member 
Fithes een ces LST SEO Library ... . :  QRDARS 
Member... . . :  $SQRPT Record. < «435, (1 
Controls. 2. cas Colunnive: 3: oss 1 
(FUlNckereesyarer resto lor 
Reco ates oi loca ane Higiene:si2viocns tives @ oie sisi e be c-cre A arese: atin sue) eresvsectioneteis Oseersreth visce wile vice tiarers 
lexkkkkkkkeekeeeeeee € Line 1 OnDemand FARMERS NATIONAL BANK 
BANK 001 « Line 2 
keRKKKRKKRKRKKRKRKEER € Line 3 OnDemand FARMERS NATIONAL BANK 
BANK 001 « Line 4 
1----- eke € Line 1 OnDemand FARMERS NATIONAL BANK 
BANK 001 « Line 2 
BANK 001 « Line 3 
1RASORT P3313001 « Line 1 OnDemand FARMERS NATIONAL BANK 
BANK 001 
FROM 12/20/90 
TO 12/20/90 DOLLAR SEQUENCE REPORT 
T/R ACCOUNT SERIAL ITEM SEQ. 
AMOUNT NUMBER NUMBER NUMBER NUMBER AMOUNT 
3.00 05320066 1106013267 1022663900 
3.00 05320066 1106116899 10216446P 3.00 
3.00 05320066 1106116899 10219452P 3.00 
F3=Exit F12=Cancel Fl9=Left F20=Right F24=More keys 


Figure 155. Display Physical File Member - PAGE Report 


The highlighted fields (such as segmentation criteria and keys) are the values you 
use when you define the report. 


PAGE reports use the same items for Keys 1 and 2; the example uses Check Dollar 
Amount. Key 1 is the lowest Check Dollar Amount at the top of the first page of each 
segment. Key 2 is the highest Check Dollar Amount on the last line of the last page 
of the segment. (The administrator determines the segment length, from 1 to 100 


pages.) 
Key 3 is always the page number. 


These are the keys in our example: 

* Key 1 - Beginning Check Dollar Amount 

* Key 2 - Ending Check Dollar Amount 

* Key 3 - Page Number (set by OnDemand) 

* Key 4 - (none) 

* Key 5 - (none) 

PAGE report segmentation is different from DOC report segmentation. (Examples 
throughout this book use DOC reports.) You identify the starting page location 
(possibly excluding banner pages, for example); then OnDemand segments the 
report based on the size of the segment you define in the report definition. 


To view additional columns, use the F19 and F20 keys. 


Scroll forward to view additional items, or enter_a B in the Control field to go to the 


Bottom of the page, as shown in |Figure 156 on page 106 
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106 


Display Physical File Member 


Fev ee nr ata er tie! ehSISEO Library ... . :  QRDARS 

Member... . . :  $SQRPT Record s 33. ¢ 11593 

CONtKOlE sets ess B COMUMMIGs ee tetonere cus 1 

Either Sou ceeal ook 

ea rerurtreneie cil iace-ecateereieiniC saree aca tase Ore gecve tie viens ll cteswrertia eteieo Weiscerert vests Oc wrerettierenvieilis s etedee- eos 
4.88 05320696 411166648 27407112B 4.89 
4.88 05320705 551500903 10206066P 4.89 
4.88 05320710 003140938 17306998B 4.89 
4.88 05390022 103889457 13436265N 4.89 
4.88 05390022 103974028 13445255N 4.89 
4.88 05390022 321877540 1095 02636776N 4.89 
4.88 05390022 322185430 2527 402120931 4.89 
4.88 05390022 322258567 0109 10508512P 4.89 
4.88 05390022 322827775 7342 400061001 4.89 
4.88 05390022 323302216 741164 404067881 4.89 
4.88 05390022 541844296 13435022N 4.89 
4.88 05390037 55050439 10710263P 4.89 
4.88 05390150 721013902 10227150P 4.89 
4.88 06100010 8801045801 41709435P 4.89 
4.88 06500002 110017072 20209749P 4.89 
4.88 07192322 930000709349 30907789P 4.89 


xxeeek END OF DATA ****** 


F3=Exit F12=Cancel F19=Left F2Q=Right F24=More keys 


Figure 156. Display Physical File Member - PAGE Example 


Return to the Top of the report data by entering a T in the Control field at the top 
of the screen. Use the sample data to locate: 


Key 1 The first Check Dollar Amount is on Line 7, starting in Column 2. (Assume 
that this dollar amount can contain up to 11 characters.) 


When locating the column number, include the print control position. You 
can use the ruler at the top of the screen as a guide. You could locate and 
define this key to OnDemand by using absolute processing with the data 
that is defined on a fixed line. However, we recommend using pivot 
processing to define it, particularly when the report is 2-column. (Use a 
pivot value for Key 2, also.) 


We selected ’.” in Column 10 for the pivot point. When OnDemand finds 
the first occurrence of ’.’ in Column 10 (looking down the page, starting at 
the top), it extracts 11 characters on the same line (0 lines offset), beginning 
at Column 2. This creates the Key 1 value. 


OnDemand then searches from the bottom of the page backwards, using 
the same criteria, to fill in the Key 2 value. 


Key 2 Data flows down the left side of the page, and then starts again at the top 
middle of the page. Assuming that this might be a 2-column report, the 
last Check Dollar Amount might be found in Column 68 (as our example 
shows), and is 11 characters long. To find the line location, use pivot 
processing, selecting ’.” in Column 76. 


OnDemand searches backwards from the bottom of the page. When it 
finds the pivot value, it replaces the previously filled Key 2 with the value 
in the second column (if it is nonblank). 


For a 1-column report, define key 2 as you defined Key 1; OnDemand 
searches backwards for Key 2. A 1-column report is more common than a 
2-column report. 
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Segmentation 
Locate the beginning of the actual report. 


In this example, there are seven lines of information preceding the actual 
report data to be captured; they can be leading banner pages, or printer 
alignment pages for preprinted forms. 

To identify the beginning of the report, you can select from several options: 
* Amatch on RASORT on Line 1, Column 2, with a length of 6. 

* A match on P3313001 on Line 1, Column 13, with a length of 8. 


The report date is at Line 3, Column 11, with a length of 8. The date 
format is MM/DD/YY. (The date must be in the first segment of the 
report.) When you define the report, you must include the date format. 


Define the report to OnDemand 
Select|“Option 4. Work with Report Definitions” on page 18)from the 


Report ADMINISTRATION MENU. 


There are differences between the DOC report definition shown on those screens 
and a PAGE report definition. 


* Define the environment for a PAGE report, using [Figure 157|through |Figure 159 
lon page 108} 


(— ies ; 7 
Report Definition - Environment ONDMD400 
1/08/98 14:49:43 
Type choices, press Enter. 
RED OTE ames rtrea cute contin Menten wai ea « TSTSEQ___ Name 
VerSiOnhticarsaena satesicecinsd cbs cetcens ren a mrvan eh 72 01 01-99 
RE PONCE VD Canc earceten eecatcene rrr) Vosncon ems vubteiucenvetine PAGE DOC, PAGE 
NODX, UBND 
Enputsrecorduiengthimcs c2 Sevsccteienc. sor ce ee tee sts 133 20-256 
PONG VsiNaMe® <tee se Renee tenes cemiay pests eoeente D9OOPTICAL Name 
Reportoverlayic. cis at ace i svccelea sl 4: ten et eins Name 
REpOGt datas types sce 5 iw cove eensa a: act he Soe ee el *OTHER *SCS, *AFPDS 
*OTHER... 
REPORE “GROUDM areata cnteun couche ue mlcamel ccam vol amen as Name 
Translatesprant control so 35s.ne sve en ee N Y=Yes, N=No 
Prin CO sR Or ee ves coe eter tat austes courage vstee temmenae Name 
EaDMa Va eeoyxsn tse ve cemacunse co eon cot eee ure terme antes 
MOXIE 3e eh ba eevee fer es Mave oe Meer iss epi ie! cer te: Sen aed isp fe) es Dollar Sequence Report___ 
COMPGESSi/ Onin eae ears yeeros memcaa suns) Cemreetemeneatt 1 Y Y=Yes, N=No 
Posting date: type: =. <2 Sse ee wkd ee 1 
More... 
F3=Exit F12=Cancel 


S | 


Figure 157. Report Definition - Environment PAGE Example (1 of 3) 


Notice PAGE in the Report type field. Complete the fields as shown, and press 
Page Down to move to|Figure 158 on page 108 
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Report Definition - Environment ONDMD400 
1/08/98 14:50:49 
Type choices, press Enter. 


Posting date: 


TEYD@ srecsst xe ae. Se sees yh set es Se) ced es es een ete a 
[WeTilofie ilies pera sao Cube ra riers Simic terre ee eater 8 0-25 
GON UMM carcmececsevsgn aneeae tsa cercantay orca sae estan 11 0-255 
[IM @2 53, ae. Hes ns peh ue co tehacer Gen se de tenes wh ie ieh ea eons 3 0-256 
-OR- 
PAVOIES Via lUC oe eras) xe er aten crea rsuren eeu tur seeass 
Eemgtlice: 2c ae: keke ney Gemmean tee toe conte se er cone ee ey = 1-16 
CONUMMIemesars se atria en eters ecaeae omc ogee ee 0-255 
P= SITINGsOTTSCLS ose ce sen vor verses vances ton fesse lee os -255-256 


More... 
F3=Exit F12=Cancel 
Figure 158. Report Definition - Environment PAGE Example (2 of 3) 
Complete the fields as shown, and press Page Down to move to |Figure 159 
Ve 
Report Definition - Environment ONDMD400 +) 
1/08/98 14:51:26 
Type choices, press Enter. 
Bypass report results display ........ N Y=Yes, N=No 
Bypass document results display ....... N Y=Yes, N=No 
Search all sequence numbers ......... if Y=Yes, N=No 
DMput<@xT 5. ce Se ee oes ee Ges Wee ee Se as Name 
ISTID RON eactansg oes a caso eae vena cha, cocks nein *LIBL 
iW nfs (2b eich, (bbc jeer cea easy rece me sere rn cy airy Oe rrmer rae Area Name 
[Kenfloy at Vinh etry eeatre accel ore cle meer ren cs errr *LIBL 
Wnbundikes exit eel ciss ey ecveehau spac, ney cones Name 
[UTlOh et Yih’) parce pesca wi tat Mgeariwe ete COs enop Na eerets Ar *LIBL 
Bottom 
F3=Exit F12=Cancel 


Figure 159. Report Definition - Environment PAGE Example (3 of 3) 


Notice PAGE in the Report type field. Complete all fields as shown and press 
Enter to move to|Figure 160 on page 109 

¢ The Report DEFINITION - SEGMENTATION screen includes an entry field that can be 
more significant with a PAGE report than it is with a DOC report. Because 
PAGE reports do not have natural breaks for segments (such as the obvious end 


of each checking statement), the Segment size will determine exactly how many 
pages belong to each segment. In a DOC report, the Segment size defines the 
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maximum number of pages per segment, but this number is not often reached 
due to the natural segment breaks that usually occur after a smaller number of 


pages. 


( Report Definition - Segmentation ONDMD400 *) 
1/08/98 14:51:39 
REPOE/VERS TON) oars: ey es Cem eeoees vtec :  TSTSEQ / 01 
Type choices, press Enter. 
Segment: Siz@o 3. 5 we oe ae Se 100 1-100 
Start of report condition 1: 
Ghange/Matcht 1 ict ty Se nee te oS 2 1=Change, 2=Match 
NicillU OSs copeters tentonx eigieer ance cate sR Ore ies RASORT____ 
Henig Nine secen ses aroar tetas serene sas 6 0-25 
COUMM tonnes scseper ver cee ccn tor ation eee 2 0-255 
DING? Sos se Ree i el ee ee i 0-256 
=OR= 
PaO: VarllUGie ae ss aos ccee bon ses A 
ONG ee cee on resee es sees ensue fence _ 0-16 
LEoSIUTUINNS Barents greece reais eerye te ir _ 9-255 
tow NESOTTSECs ys. esc ce wouey “ee _ 7255-256 
Condition COMDINALION « «5. 5 2 ws « O=None, 1=And, 2=0r 
More... 
F3=Exit F12=Cancel 


Figure 160. Report Definition - Segmentation NODX example 


The field you use is: 


Segment size 
Enter a page count, which can be from 1 to 100. 


Because PAGE reports can be very long, you segment the pages for more 
convenient use. 


Complete the fields as shown. Because this example does not have a second 
segmentation requirement, press Enter to move to|Figure 161 on page 110 
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a 


Report Definition - Keys ONDMD400 
1/08/98 14:52:24 
Report/VersiOn: Ss 6 ee ee we we HS | TSTSEQ U2 «/ 01 
Type choices, press Enter. 
Key inde ieesece eee athe: oes ce Ses ceapauees fee sc Dollar Amt. 
eine el eeremcemery ern eee: eect nencn eS eer cmcr 11 1-25 
Minimum search characters ......... 1 1-length 
Location: 
Coun: beeen suesdyet op reute se duns epae te) Seed 2 0-255 
WEIN Cc Rad tose cre tt sect h oie ole raccul atest cteee eer. 0 0-256 
-OR- 
PAVOG Va UC s, curs cee tte sos Saar) cer oe fens 
E@RGENinticrsparicueetee Mca cetera uname ears i 0-16 
COUUMMMr Ge ee aecss ey werk toecouse tie tccm sss Ve las 10 0-255 
t= line offset = «2a 6 Ge % e 0 -255-256 
Lowercase key) crv tyicdue cece au tow score Y=Yes, N=No 
Key ‘Security: 2-25 5) ewe a ea Y=Yes, N=No 
MUN EN EIKOV A Seeman Op oae suis earcerca lode coset ae aneur: Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 


Figure 161. Report Definition - Key 1 PAGE Example. 


Complete the fields as shown, and press Page Down to move to|Figure 162 


( Report Definition - Keys ONDMD400 
1/08/98 14:52:24 
Report /VeErStON’ csaccpe sete © ce tale reece suas PSTESEQL oy) 01 
Type choices, press Enter. 
KeysiesnaMey etsarceetesa- ce tevy cass her ests cet cers tein es Ending Amt. 
EGR GiENS: eevee ce: eu rep ae ee reel ee Ow) ce? ae, He 11 1-20, O=Not used 
Minimum search characters ......... 1 0-length 
Location: 
Goi Umi a resrepesteve encase er occu em eetear pr cuecrnn ee 68 0-255 
LST: arenes mesa cmtsans ena icimcc ee cel cancte wien is 0 0-256 
S0R= 
PavOtrVa Weis soe se eee ce Use Man es ren renee: set ce 
QM GEM teacccsn eel cc etgene Ursus east cates 1 0-16 
COUumni Ses KA cs eles OS ee ee 76 = 0-255 
t= MNeZORTSCLY Ane 8 fy ce ee oncan sos 0  -255-256 
lowercase key sci Sw a we ee Y=Yes, N=No 
Key SSOGUP TEV e vi) ceescae 5) x, Jen tes oes eyes cee os se Y=Yes, N=No 
MUN BT Ke yee 5 8 Gates ee rier) eu chess eure fen Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 


Figure 162. Report Definition - Key 2 PAGE Example. 


— lete the fields as shown, and press Page Down to move to |Figure 163 on 


page 111 
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‘a are = 
Report Definition - Keys ONDMD400 
1/08/98 14:52:24 
Report/Versionl 4° :. 0: ew Mca ee ew Be TSTSEQ / 01 
Type choices, press Enter. 
Keyes ANaMemicrcareccniec ca oehen cairo co ecwces cee Page Number 
More... 

F3=Exit F12=Cancel 


ee 


Figure 163. Report Definition - Key 3 PAGE Example. 


Press Page Down to move to|Figure 164|through |Figure 165 on page 112). 


ia 


Report Definition - Keys ONDMD400 
1/08/98 14:53:42 
Report/NVerston °a.5 & ms Ses Ae TSTSEQ___/ O1 
Type choices, press Enter. 
GW PENNING te carey Cornea we eased enter ae ake ee 
Engst hittcevse. hep tates courage! tele sccsuveie cor merren = 1-20 
Minimum search characters ......... = 1-length 
Location: 
CO) UMM sake, cages oe cen cen ents rede eesy eke teers. ms 0-255 
EUTIGSS Ge: cea tok dos Ges tentes car eo tes Wend cee tow ae ee = 0-256 
-OR- 
PiviOtavalUCr riers misemstce: ay Psetee poukeieceynsemericen ss 
E@MGthi® i: cer cs- toy rep crits: es Mertet ey en wae ieee a, 0-16 
(OP HOT gene oh ctu ctw ainamien awe cia rene rae ner _ 0-255 
Tonal WIMG:tOMhS la mc cs esacatenes ee erecewerevaeoks = -255-256 
Eowerscase keyg ta ccest =, ie veipewcnd sameeren ie Y=Yes, N=No 
Key S@CURItY so wise 4. See Yee ee ts Y=Yes, N=No 
MUI alKie Vier cen cues e tame sciccsmstves Ponsa ato Sante eencrecs Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 


Figure 164. Report Definition - Key 4 PAGE Example 


=e lete the fields if needed, and press Page Down to move to|Figure 165 on| 
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Report Definition - Keys ONDMD400 
1/08/98 14:54:31 
Report /VersiOn: a6 ee ee we we | TSTSEQ U2 / 01 
Type choices, press Enter. 
Keys 5 names cee csr ceu ee cor fies 6° et oat Ses ten sues cs ce 
Wengibhs “eure rset teer es wet ete coon tues certs Weoute a 1-15 
Minimum search characters ......... s 1-length 
Location: 
CO UMM Betsctes usmes tee ers: pou eastern, $e gems = 0-255 
PAN Gis ed sieS carers Wer ge: hoe Mal ersces aeuerieen cor ues cer “eae — 0-256 
-OR- 
PAO Via UC. Yen ee cor oot. fon get sanemhey cer ts tees 
emgthny as. cs: coh re es cite cee cevte ees eres cer ear = 0-16 
CONUMM Mee em siete ese cme cme mc reer ater. ox 0-255 
Ho) IMMNE@GONTSEL: os se ies eee eee es 7 -255-256 
Lowerscase key) tix tyicjue ciecee au tow <cocea es Y=Yes, N=No 
Key Security 2-53 5 See ea e Y=Yes, N=No 
MUMEEN EKG VA eect Opoue aie om ceircalcmn coset enna: Y=Yes, N=No 
Bottom 
F3=Exit F12=Cancel 


Figure 165. Report Definition - Key 5 PAGE Example 


When you have completed the screen if needed, press Enter. 


Test the report store of this report. See “Option 2. Store Report” on page 72|for 


details. 


Defining a NODX Report 


Some reports cannot be classified as DOC or PAGE reports because they have no 
meaningful user-definable indexes. You can archive them as NODX (no-index) 
reports, using report name, date, segment number, and page number for later 
retrieval. You can define any report as NODX. 


The example shows the same dollar sequence report we defined in the PAGE 


report. (The spooled file was copied into a physical file named TSTSEQ and is in 
the QRDARS library.) 


To display TSTSEQ, select |“Option 6. Display Physical File Member” on page 78 
Figure 166 on page 13 


igure 166 on page 113]appears. 
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Va 


F24=More keys 


Foes suyerese Fee seseaee cee os 


Member 3532) 25 a ewes SP ce 


F3=Exit F4=Prompt F5=Refresh 


Type choices, press Enter. 


Display Physical File Member (DSPPFM) 


ree ae TSTSEQ Name 
oe ess QRDARS Name, *LIBL, *CUR LIB 
ue tae ate eS RERST: Name, *FIRST, *LAST 


Number, *END 


Bottom 


F12=Cancel F13=How to use this display 


Figure 166. Display Physical File Member (DSPPFM) 


Enter the file name and library as in the example, and press Enter to continue to 


the DispLay PHysicAL Fite MEMBER screen, 


Ve 


FANG. ec cs, Geta asl 


[RAK AK AKKKKKKKKERERE 
BANK 001 
KKKEKEKKRKKEKRKEKR KER KER ERE 
BANK 001 

Sees Soe KRKEKEKKKK 
BANK 001 
BANK 001 

1RASORT P3313001 
BANK 001 
FROM 12/20/90 
TO 12/20/90 

T/R 
AMOUNT NUMBER 
3.00 05320066 
3.00 05320066 
3.00 05320066 


F3=Exit F12=Cancel 


Display Physical File Member 


a 

= 

oO 
FPwWNrFBWNE 


ACCOUNT 
NUMBER 
1106013267 
1106116899 
1106116899 


Fl19=Left  F2Q=Right 


Library ... . :  QRDARS 
Records: wt 8 al 
GOUUMMmceay betes il 


OnDemand FARMERS NATIONAL BANK 
OnDemand FARMERS NATIONAL BANK 


OnDemand FARMERS NATIONAL BANK 


OnDemand FARMERS NATIONAL BANK 


DOLLAR SEQUENCE REPORT 
SERIAL ITEM SEQ. 
NUMBER NUMBER AMOUNT 
10226639 3.00 
10216446P 3.00 
10219452P 3.00 


F24=More keys 


Figure 167. Display Physical File Member - NODX example 


Keys NODX keys 1 through 3 are created for you by OnDemand, and are: 


* Key 1 - Segment Number 


° Key 2 - Date 


* Key 3 - Page Number 


Additional fields 


You can define these: 
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* Key or Display Field 4 
* Key or Display Field 5 
Segmentation 


NODX segmentation is identical to PAGE. Follow the instructions for 
segmenting a PAGE above. 


Define the report to OnDemand 


Select|“Option 4. Work with Report Definitions” on page 18)from the 


Report ADMINISTRATION Menu. Enter the field information as the examples 


show in|Figure 168/through |Figure 170 on page 115 


( Report Definition - Environment ONDMD400 
1/08/98 14:49:43 
Type choices, press Enter. 
RE PORE ic toy te oe enter Setter ier <n cer sh aemeist See “oreo ser nat cs NODXDOLSEQ Name 
VERSTIOND Mexicom sae ue encabed sp terbomh meant any masts ensaes 01 01-99 
RE DOME: ALY DC wircarenrrcaroactiscomn omnes tered cea heim comrehe crises NODX DOC, PAGE 
NODX, UBND 
Tnputrecord: lengthy 20 sy 4.45.0 82 cotease cy oe 133 20-256 
PO!IG Ysa AMO svaree cents tosh ere nan veinaed ones eraten etnias D9OTAPE__ Name 
Report soverliayiis cee: tg cen <i cass sens) Sees ove en Name 
Report datasity pens <.cc) 22s) as eer as ey fe se cd *OTHER *SCS, *AFPDS 
*OTHER... 
REPORESONOUD Ms rc sens corse sure ten vemusre smc acciene. yen: Name 
Translate: print.control ... sc. 4 a Ak Y=Yes, N=No 
Printer Tlie (2 sso woe ce es ee eh we ee es Name 
Lee Aenervnaeriny Mo acter cst errac ees woes) vane 
MEX Saar dete ro mrerts stake eronrs aves “onmeceeu yen foul stucer care NODX Dollar Sequence Report__ 
COMPRESS TONG 2 coukotee eros tay cers cies eotiss ceimter on cote es if Y=Yes, N=No 
Posting -datestype. is) ace ve) a) Geass eas ee 1 
More... 
F3=Exit F12=Cancel 


\ 


Figure 168. Report Definition - Environment NODX Example (1 of 3) 


<r lete the fields shown, and press Page Down to move to|Figure 169 on 


114 IBM Content Manager OnDemand for iSeries: Administration Guide 


a =~ 


Report Definition - Environment ONDMD400 
1/08/98 14:50:49 
Type choices, press Enter. 


Posting date: 


UY DD Ciren tose ses asl ecwecse Gee leas Sel cee er 60 gen en ene i 
Hep (ofc ecient ees erat aa rtere ree ieee tee oe 8 0-25 
GO) UMM ane urcn es urrmeoenmece: Tat ee Cran aveae swag wer 11 0-255 
[IMG Note ene ae cet ete ssise Geese Web er ee Se fet asy fore 3 0-256 
-OR- 
RiaVOieVia UEP cscn cs ete cco en smeepc ts stemen ecaemee 
Being tliesaten te: Ses ect tes cen cote een tor ce cee eg tence Mean _ 0-16 
COLUM Naveen eevC aes ac trme ate eee at ays _ 0-255 
Fel MER OTS OL vo ves eeu ce ccakcn ts cease Momteutr rene -255-256 


More... 
F3=Exit F12=Cancel 


i yo 


Figure 169. Report Definition - Environment NODX Example (2 of 3) 


Complete the fields shown, and press Page Down to move to|Figure 170 


a wae > 
Report Definition - Environment ONDMD400 
1/08/98 14:51:26 
Type choices, press Enter. 
Bypass report results display ........ Y=Yes, N=No 
Bypass document results display ....... Y=Yes, N=No 
Search all sequence numbers ......... Y=Yes, N=No 
DNpUT CXchibe anon ow tena ee cun wear stera te vole tut ans Name 
iD Ranvier ser saerer antent. rae” ween ar. crhincde san oa ys *LIBL 
Dndexsex ices <ieesce 2h en eo fener ctsctey rameces sek eres Name 
EniD ra Rye teenie eer a sunen can cerca Vm aicaw. *LIBL 
Wnibundiiesexnt: eoesst ce dts en ee eh este ned Name 
Dib ray Vawcierurs cee cnr atcheme cram cta cairns *LIBL 
Bottom 
F3=Exit F12=Cancel 


Figure 170. Report Definition - Environment NODX Example (3 of 3) 


Complete the fields shown, and press Enter to move to|Figure 171 on page 116 
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a =~ 


Report Definition - Segmentation ONDMD400 
1/08/98 14:51:39 
Report/Versiion: ..0e 6 ts fen oe as :  NODXDOLSEQ / 01 


Type choices, press Enter. 


SCQMENEMSHIZES cates pte ete teeta ce 100 1-100 
Start of report condition 1: 
Ghange/Match: <i0  iaee Bs we on 2) 1=Change, 2=match 
EHC inPaaereerss Rey eren cies comhsnert vneacy see ora RASORT. 
E@NG tis coma n eu rsure etc see cans wees 6 0-25 
GO UMM is ctucrss tt obe hol ecP reece neal cs een toler s 2 0-255 
Hilti acearcara ae per eRe nc oce se rans 1 0-256 
-OR- 
Bin oteval Ut cmroruesueeica-s cuhel or was 
[EC STae hel 1 ye Ren eons sey wae sh eer vty craeet ~ 0-16 
COMMIS eee: ev eecets, ve erie Peeves, cme ou, 0-255 
A= VINES OMTSCES fs. hee con eke ssn cou ce —_ -255-256 
Condit iow COMDINALION s % < a aw + x 0 0=None, 1=And, 2=0r 
More... 
F3=Exit F12=Cancel 
Figure 171. Report Definition - Segmentation NODX example 
Complete the fields shown, and if you have no other segmentation requirements, 
press Enter to move to |Figure 171 
ra 
Report Definition - Keys ONDMD400 ) 
1/08/98 14:52:24 
ReportyVersion: <6. as ce er cn oe en —“NODXDOESEQ:/ 01 
Type choices, press Enter. 
Key a Since krcsesmeraresec meme teak reenter uae Segment Number 
More... 
F3=Exit F12=Cancel 


Figure 172. Report Definition - Key 1 NODX Example. 


The field is completed for you as shown. Press Page Down to move to|Figure 173 
[on page 117] page 117 
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Report Definition - Keys ONDMD400 
1/08/98 14:52:24 
Report/Version) 4.5% Yew Sew a et © NODXDOLSEQ’/ 01 
Type choices, press Enter. 
Key 2 MaMO Ge a, cover copied co ssn es tery spares ao ese ere Segment Date 
ENGL Naess cree sarcnystccons avemccurceee anon our aL ce ras 8 1-20, O=Not used 
Minimum search characters ......... 8 0-length 
More... 


F3=Exit  F12=Cancel 
NEC 


Figure 173. Report Definition - Key 2 NODX Example. 


The fields are completed for you as shown. Press Page Down to move to 
Figure 174 


“<a 
Report Definition - Keys ONDMD400 3 
1/08/98 14:52:24 
Report/Versiion® eae) cee es eee ce ue. NODXDOLSEQ:/01 
Type choices, press Enter. 
KeycSiimames vn vaatse sf caves Sout, bee vatuies fous es ceaive Page Number 
More... 
F3=Exit F12=Cancel 
yy, 


Figure 174. Report Definition - Key 3 NODX Example. 


The field _is completed for you as shown. Press Page Down to move to|Figure 175) 
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a 


Report/Version 


Report Definition - Keys 


Type choices, press Enter. 


ONDMD400 
1/08/98 14:53:42 
NONDXDOLSEQ / 01 


Key SAMO eat ae ee es, oan as ena ceca 
WONQiG Na eure rset stvr es we ete coon tates certs Neste a 1-20, O=Not Used 
Minimum search characters ......... s 1-length 
Location: 
CO UMM Betsctes uemees tee cers: pou esters, $e gems = 0-255 
VAM Sie as ses carers er ges hoe Mal ese seu erieen cor ues cer “ean — 0-256 
-OR- 
PAVOt Via UC sc, 2 rs ee tote Sos ce) Saas) cer oe fens 
Bemgthiy ac. cs: coh re Bes cite cee cevte tee epee ear = 0-16 
CONUMM Meee siete ese cme cmn en ec rem ater. ox 0-255 
Ho) IMMNE@GONESELS os ve tee eee oe ee es 7 -255-256 
Lowerscase key) tix ysis cess au tow wcocen es Y=Yes, N=No 
Key Security 2-55 5) eee a ea Y=Yes, N=No 
MUMEENEIKG VA eeert on Opoae a eelie acerca lice or osmr ae aneur: Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 
/ 
Figure 175. Report Definition - Key 4 NODX Example 
Complete the fields as needed, and press Page Down to move to |Figure 176 
( Report Definition - Keys ONDMD400 *) 
1/08/98 14:54:31 
Report/Version <cf s ee a igs sce ee -NONDXDOLSEQ: 01 
Type choices, press Enter. 
Key Sesame: ots arrineeese ot evveaseeher fem cote ten tenka te 
IRGNG.CN ap eteren co eu Meiers ene sn testteknwcuerc scence ce es = 1-20 
Minimum search characters ......... o 1-length 
Location: 
GON UMM eNeepa cet vee oe wt co Men ese teres cat cee _ 0-255 
ESN Ceaepe sees etc el anc ueN ec eteme rae rae erwh van ates wire _ 0-256 
SOR= 
Pav Otreva leu, esac eee co ust Men rs ren ranee: ete 
Eengthimprmcroe; pet ncriemcatcce sia mr cneeattn rs = 0-16 
CON UMM aetese wren not cout ema he, Cosy oy reires newts ace _ 0-255 
A= VIM@SORTS@L) a oe eo Gace te tenes ah ce = -255-256 
lower icase key 2 cits Se we ee Y=Yes, N=No 
Key SS@GUPIGY. Ss) ere ce tb oe, fen tes oes epee cee ose Y=Yes, N=No 
MUN SIKOVie%, “cotea stesuryts ise conte ene cantatay caer) fonts Y=Yes, N=No 
Bottom 
F3=Exit F12=Cancel 
/ 


Figure 176. Report Definition - Key 5 NODX Example 


You can complete the fields as needed. Press Enter to complete the definition. 


Defining a UBND (Unbundled) Report 


Spooled files can contain more than one report. You can split (unbundle) the 
spooled file by report, then index and store them separately. Each report in the 
spooled file must have a report definition. 
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There is no restart capability for unbundled reports. If an error condition occurs 
while you are storing them, you must manually set up your OnDemand 
environment for restart; correct the error condition and delete all reports that were 
stored during that cycle. 


The UBND example, beginning with |Figure 177] shows two reports, TSTINVM and 
TSTSEQM, in the spooled file. 


Display Physical File Member (DSPPFM) 


Type choices, press Enter. 


Fuldh@cersecaa wee mnc rae san carr facor rer ape BUNDLEO1__ Name 

Mars Ss, se esuete oer eutmesouslce MYLIB Name, *LIBL, *CURLIB 
Member: se® croc weare: tense teh coarse *FIRST Name, *FIRST, *LAST 
Rromisrecond. camsgsmser tae. uellcres 1 Number, *END 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 177. Display Physical File Member (DSPPFM) - UBND Example 


Press Enter to continue to the DispLay PuysicaL Fite Memper screen, |Figure 178 on| 
[page 120| age 120 
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Display Physical File Member 


Fide che verses se “BUNDEEOL Library gs. 2 acy” MYETB 
Members ace te 28 BUNDLEO1 Record! « 6:6 1 
GOMEGONE “sete seuss COMUMMIRs eetesmea sce 1 
[Eillths lean teen creer oa 
Kreverstrecmes ctl wwcecgea teeryiwini’ scera-e-tiaea ee Gier gece ctiy viene creswcestie eieie o foisrerech eens Os aoecact srry wile ereredee ccd 
1 **TSTINVM « Line 1 
1 ¢ Line 1 
-  ¢€ Line 2 
- € Line 3 
ALMON SAFETY EQUIPMENT ALMON SAFETY EQUIPM 
137 EAST BROAD AVENUE 137 EAST BROAD AVEN 
ALBANY, GA 30709-3590 ALBANY, GA 30709-35 
0 
0 300 BEST WAY C000323 31709 1234567890 
UPS 
FREE 
ORDER OVER 1000.00 
03424 TREADLE ASSEMBLY EA 20.000 
99001-1 SPRAY UNIT - PVT LABEL EA 15.000 
03591-10 WHEEL 12 IN DIA 
26006-22 TANK 12 BY 24 INCHES 


xkkkkeee* (Multiple invoices follow) **xxkxxxHe 


xkkkkeeeee (end of pages of invoices) xxxKkKKKHKK 


1 **TSTSEQM « Line 1 OnDemand FARMERS NATIONAL BANK 
BANK 001 « Line 2 
BANK 001 ¢« Line 3 
1RASORT P3313001 « Line 1 OnDemand FARMERS NATIONAL BANK 
BANK 001 
FROM 12/20/90 
TO 12/20/90 DOLLAR SEQUENCE REP 
T/R ACCOUNT SERIAL ITEM SEQ. 
AMOUNT NUMBER NUMBER NUMBER NUMBER A 
3.00 05320066 1106013267 10226639P 
3.00 05320066 1106116899 10216446P 
3.00 05320066 1106116899 10219452P 


xexxxxeeee (Multiple pages follow)  ***xkkkKKKK 


xeexxxexee (end of pages of report) *x*xKKKKKKK 


F3=Exit F12=Cancel Fl9=Left F20=Right F24=More keys 


Figure 178. Display Physical File Member - UBND Example 


Segmentation 
The segmentation criteria (used to find the individual report names) can 
reside either within the first segment of the report, or on a page preceding 
the actual data (such as a header page, or a page your program inserted 
for OnDemand report identification). 


The report name must be consistently in the same location on the page for 
each new report. You can use a Change condition on either a fixed line 
location or on a pivot value. 


When a new report is found based on your segmentation criteria, 
OnDemand processes that report (using its report definition) as if it were 
the only report in the spooled file. 
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Define the report to OnDemand 


Select|Option 4. Work with Report Definitions” on page 18 


Administration Menu. \Figure 179|appears. 


from the Report 


a 
Report Definition - Environment ONDMD400 +) 
1/08/98 14:49:43 
Type choices, press Enter. 
REDOWRG: reg shu cares ist reife te aestmet eters ite mcen tol et “6 BUNDLEO1 Name 
VeErSiON) (2 34) es Ye SS eee ie ee we 01 01-99 
REPORETEV DC. wrecesecieverotgt eeu stn mucin mura mear ws UBND DOC, PAGE 
NODX, UBND 
Input arecord: dengthi “22 sess ey fete some oes ed 133 20-256 
POM yan ame Oc eee ew cmeeuslnts wstoce cs vel ts teed se D9OTAPE. Name 
Report: overlay” <. ss. x. ts ess we Ee ww Name 
Report datatype: so5s 0. eis cae: eee *OTHER *SCS, *AFPDS 
*OTHER... 
REPOCMO OUD sro seracemahe wt mere c enemas evn decane tare Name 
Imansilate: print control, i te ous, cece oe es 3) N Y=Yes, N=No 
PYM COR Hiiliceegoe-s: 02 cs ss. nec dans ce en cures te) wsebcor ean Name 
EID VaIY eer ese, teen hee Ae os cet ce) ce et ae, eee oer eee 
MOXEa tect cecaser ier bon soneaee te: mee Got ls eeaneuyeneen “sortsunes cedars Bundle of miscellaneous 
reports 
Compression = <5. ws aoa es ee ee ie Y=Yes, N=No 
Postingmdate: type: 210 2. i a Ge ee Go ies ee i 
More... 
F3=Exit F12=Cancel 
S yy 
Figure 179. Report Definition - Environment UNBD Example (1 of 3) 
Complete the fields as shown, and press Page Down to move to |Figure 180 
a nee ; % 
Report Definition - Environment ONDMD400 
1/08/98 14:50:49 
Type choices, press Enter. 
Posting date: 
(LA OSEeN Ramee ark oatie ce ene cpern hee Sete eos ee 1 
Fengt Wiesgtmrsncaeciens bien ae alent acne are 8 0-25 
CO MMM: Ge eo WA et ce ee a eee eee en ee 11 0-255 
EI =ssees ecenrpetie raceme meter eM cuera rh Mra Rar Fthes. ee 3 0-256 
-OR- 
Pivot-value” .9:9 0 4c a ea Se ee See ee ee 
GmG hiss ceetemes: “oF set cet len ceriice toute cer ven cos ene _ 06-16 
CO UMM Pieces eee irons) enresne tenses vein lonecne te _— 9-255 
Hae al MMGLOM NS Clacare membe cus) sre: Rewer isu ferucs __—- 255-256 
More... 
F3=Exit F12=Cancel 
XN ey 
Figure 180. Report Definition - Environment UNBD Example (2 of 3) 
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Complete the fields as shown, and press Page Down to move to|Figure 181 


( Report Definition - Environment ONDMD400 4 
1/08/98 14:51:26 
Type choices, press Enter. 
Bypass report results display ........ N Y=Yes, N=No 
Bypass document results display ....... N Y=Yes, N=No 
Search all sequence numbers ......... 6 Y=Yes, N=No 
TNPUTE CXR cy teen se ctaset ce cs Ueldsr oes siete ce ies pene Name 
EVD Y:ae Varese cu creak acme cre atom voitcaet Orme coer cam sae *LIBL 
Index exits. 2 Ss. eo8i ek A se Soe ee Name 
ETD RaneVee Rn eemc enous tase tine ten (caacne si crannar carvan: *LIBL 
Wnibundikesexdsts cs. eit. oksp cous. ves “os eecueh woe eurst hoe ce Name 
Inia GV duke consuls certs woue mec wee keene cue Tasers *LIBL 
Bottom 
F3=Exit F12=Cancel 


Figure 181. Report Definition - Environment UNBD Example (3 of 3) 


OnDemand extracts the report segmentation value that you define as a Change 
(see below) and passes it to the program named in the Unbundle exit field if one is 
specified. Using this technique, you can change the report name extracted _to a 


different report name that matches an OnDemand report definition. See|Unbundle 
Exit” on page 29 


mn page 293]/for more detail. 


Press Enter to move to|Figure 182 on page 123 
Complete the fields as shown, and press Enter to move to|Figure 182 on page 123 
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Report Definition - Segmentation ONDMD400 
1/08/98 14:51:39 
Report/Verston) so. a4, 6 ess :  BUNDLEO1_ / 01 
Type choices, press Enter. 
SEGMENESTZE® Geo 35 as yen ce et a es wey des 100 1-100 
Segmentation condition 1: 
Ghange/Matchy s.<. x 0<%. Sa a Se 1 1=Change, 2=Match 
Via WetAocercmrswetaerecee-a riven ocuesh tere ae 
@ngth Moore fiom eee se Ricn ten eae en oars 10 0-25 
Gon NT nlemecacse reno, oe oe ase het ere ae vi 0-255 
ESS ra eesneon ae (RS hacen ornate eer 0 0-256 
-OR- 
PaO Vial Uhre secae-tateuctwectesa eutence Kk 
lkengthy cs yemeteuciese ess vei getosvesn os cues 2 0-16 
COMM: ee) 6 es ce ae: re er Abas 5 0-255 
Heo ViNe@sORTSEts eos Gs. we ee Sa es 0 -255-256 
Condition combination = « «44 6 4 -% 0 0=None, 1=And, 2=0r 
More... 
F3=Exit F12=Cancel 


Figure 182. Report Definition - Segmentation UNBD Example 


When OnDemand extracts the report segmentation value that you defined as a 
Change for each different report in the bundle, a separate report capture is run for 
each individual report, resulting in separately archived reports by each name. 


Press Enter to complete the UBND report definition. 


Defining an ANYS (AnyStore) Report 


AnyStore report definitions are very simple and represent a subset of a typical 
report definition. As shown in the screens that follow, there are only a few 
mandatory fields. One of the most significant requirements, for example, is that 
each AnyStore report definition must belong to a report group. Refer to 
[Using the OnDemand AnyStore Feature” on page 167|for more information about 
AnyStore requirements. 


Define the report to OnDemand 


Select|“Option 4. Work with Report Definitions” on page 18 
Administration Menu. Figure 183 on page 124|appears. 


from the Report 
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Report Definition - Environment ONDMD400 
1/08/98 14:49:43 
Type choices, press Enter. 
INS]ti0) les ceesaarch wre aaron Seguec ata USh.O 8c) ade cche pelecel Courts SPREADSHT_ ame 
Version: <2 Sw he Ge ee Se os 01 01-99 
REPORESEYDE: Helen ce ato tes tar coe ss ee Sel en eer ese ANYS DOC, PAGE 
ODX, UBND 
Input: record length «2%. <. 24% 24 a5 3 20-256 
Poliicyr names occu tate) sse uss eel den ceess sinks oa ves D9OOPTICAL ame 
Reportcoverlayiay vsa.ck cc! cso cn ceo ven venten care tears ame 
Reporte dataiityper ert: 6. ta, es eos ee Oe on cee es *IFS *SCS, *AFPDS 
*OTHER... 
REPORELGROUD S22 co fi ote sheer ven ves “on tes esiuees “oul euash cen ve ANYSGROUP_ ame 
Translate: print: controll 2 s.%. ss). 240 N Y=Yes, N=No 
Printer tallies coves caer toy vet oe Ue) dot cl ceaeeece sue ee ame 
ETD ARVs Gente: eo se ce me, ce ei rea cemicmn ey crete wees te 
INE Xbas Se Merce a Roope cate eRe ee wee Ree race OL ES AnyStore IFS files (spreads 
heets 
Compression is gos. 6 we se ee Oe es N Y=Yes, N=No 
POSEIINGrdabeetypess cecee lec cer seuss nemo sot oo: conte es 
More... 
F3=Exit F12=Cancel 
Ne e 


Figure 183. Report Definition - Environment ANYS Example (1 of 2) 


AnyStore ignores entered fields that are not required on this screen. The fields to 
complete for AnyStore include: 


* Report name 

* Version 

* Report type (must be ANYS for AnyStore) 
* Policy name 

* Report data type 

* Report group (mandatory for AnyStore) 

° Text 

* Compression 


The fields to ignore are: 
* Input record length 

* Report overlay 

* Translate print control 
* Printer file/library 

* Posting date type 


When ce complete the required fields, press Page Down to move to|Figure 184 on| 
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Report Definition - Environment ONDMD400 
1/08/98 14:51:26 
Type choices, press Enter. 
Bypass report results display ........ N Y=Yes, N=No 
Bypass document results display ....... N Y=Yes, N=No 
Search all sequence numbers ......... ig Y=Yes, N=No 
RN pUtLS CXlibewae oe -ocyer eh Pourcuinonraaet ehcp torn aerae esse Name 
EqDVANYS eee a cel eee ceed oe) eo; g whe verinies Seed asp tee *LIBL 
DNdexs exit rv rcsty een ustoauco cst tic asm any cuen seen es Name 
EID Ga RVaotesmup say cee caste ceca ow stents Nomecute ness *LIBL 
Wnbundillesexiity rk: ease shale fc vs tar e etsy oes anes Name 
Bibra nyemecras acy once twas cacy cre a em aes *LIBL 
ODFECtRCasSsrsetucitcte ovale caterer cuore scat 0-9999 
Bottom 
F3=Exit F12=Cancel 


Figure 184. Report Definition - Environment ANYS Example (2 of 2) 


This is the same screen that is used for standard Spool File Archive reports. The 
only field of interest for AnyStore is the Object class, which can contain a 
predefined value from the list below: 


No object class specified 
Bitmap-type object 
GIF-type object 
PCX-type object 
PDF-type object 
PostScript-type object 
TIFF-type object 
JPEG-type object 


N HSH o8§F *® W NY F SO 


There is no concept of report segmentation for ANYS report definitions; the 
program that calls the AnyStore APIs determines segmentation. Therefore, pressing 


Enter moves you directly to|Figure 185 on page 126 
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Create Report Definition - Keys ONDMD400 
1/08/98 14:52:24 
Report/Versiion: sacs bee ars «a eo 4 Se GSPREADSHT / 01 
Type choices, press Enter. 
Key s1einameaeeersmecute csr sete onset com carer sukesrstce Filename. type 
WONG hts sacs eeeecseve sy eae heen ce ran open ae teas 12 1-25 
Minimum search characters ......... 1 1-length 
Location: 
Coun See tn uesdy et op reute se duns epae ie Seed By 0-255 
WEIN Coie teee cre tty shoe oe oe rach aber at cuteee eines 6 0-256 
-OR- 
PAVOG Va UC se, crs cee tte soso Gaara) cer oe fens 
E@nGtNintccparcueste teach oie re oun ametuer 0 0-16 
GOuUMMbresre a stacncey vous ecmcun et ate tere caves 0 0-255 
t= line offset = «sa 6 eee «+e 0 -255-256 
Lower-caSekeye vie cine. stress seu coe sayin es Y Y=Yes, N=No 
KEYSSeCUnTEY Sees, Se eis bees es ee see es vi ne N Y=Yes, N=No 
MUN EN EIKOV A Secercn poke suis emceccalodeorcnmrr ee a eas N Y=Yes, N=No 
More... 
F3=Exit F12=Cancel 


Figure 185. Report Definition - Keys ANYS Example (1 of 5) 


Complete the fields as needed. (As you can see, this is the same screen that is used 
for standard Spool File Archive reports (such as DOC reports). Many of the fields 
do not apply for ANYS reports (such as all the Location fields). These fields are 
ignored if entered.) 


Press Page Down to continue to the additional key screens or press Enter to 
complete the ANYS report definition. 


Spool File Archive Security - In Detail 


OnDemand’s archived report document retrieval follows a four-step process. First, 
the user selects a report or report group by name. This report name is the name in 
a report definition record. The report name corresponds to the directories where 
archived report objects are stored and to the authorization lists that are used to 
secure them. This extends to their contents as well. 


The second step, after selecting the report name, is to select a particular occurrence 
of that report. An occurrence is an OnDemand archived spooled file that uses the 
report name or definition which describes that report. One of these spooled files 
may be referred to as a report object. OnDemand identifies these report objects by 
date and sequence number; for example, 19970412.002 is a typical object name. 


Next, select the specific segments or pages of the report object by entering one or 
more search or key values. The entered search values are matched against 
corresponding key values that are extracted from the report object’s text when 
OnDemand archived it. The search returns a list of report segments which match 
the search values that are entered by the user. 


The fourth step is selecting the report segments for retrieval from the list of key 
records that match the search value that was just entered above. 
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In summary, there are four parts of report retrieval. They are report name selection, 
report object selection, entry of key values, and selection of one or more segments 
to be viewed, reprinted, or transmitted via fax. 


OnDemand security functions are applied during the first of these steps, report 
name selection, and during the third step which is the search that is based on the 
entered key values. Report security controls access to archived reports at the report 
name level. Key security permits or limits access to particular segments or pages of 
archived reports, based on the actual values in key or display fields. 


The following two sections address the impact of these security features: First, 
“How OnDemand Security Works”|describes operational features that affect all 
users; then, |“How to Setup OnDemand Security” on page 130/covers items of 


interest to the OnDemand administrator. Within each of these two main sections, 
information on report security is followed by that for key security. 


How OnDemand Security Works 
Report Security 
Retrieving Lists of Report Names: 


Listing Individual Report Names: When retrieving archived reports, the SpEciFy 
Report SEARCH screen allows the user to select from a list of existing report names. 
This remains true whether performed by selecting the Retrieve Reports menu 
option or by starting the FNDRPTRDAR command. You generate the selection list 
by pressing F4 while positioning the cursor in the Report field. (Alternately you 
can enter a generic or partial search value such as AP* in the Report Group field.) 
The generated list of report names includes only report names which the user is 
authorized to retrieve and which have at least one archived report. 


Using Report Group Lists: When retrieving archived reports which are in a report 
group, the Speciry Report SEARCH screen allows the user to select from a list of 
existing report groups. You generate this list of report groups by pressing F4 while 
positioning the cursor in the Report Group field. Alternatively, enter a generic 
value or partial search value such as AP* in this field. At this point, the list of 
report groups displays without any report security checking. That is, the list shows 
all defined report groups. Report names that are shown in the Select Report Result 
list depend on the following: 


* The user selects a particular report group to which he is authorized. 
* The selected report group contains at least one archived report. 


Selecting Report Names: 


Selecting a Single Report Name: When the user chooses one particular report name 
from a list of report names as described above, report security will have already 
been checked. OnDemand sends an error message indicating that no reports were 
found for the name specified when a user does one of the following: 


* The user enters a report name to which he is not authorized on the Spsciry 
Report SEARCH screen. 


* The user is not authorized to the report using FNDRPTRDAR. 


If an unauthorized report name is used in the FNDKEYRDAR command, a 
response is sent. This response indicates that access is denied and that the user is 
not authorized to access this report. 
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Using Multiple Reports (a group search): If the user selects a report which is in a 
report group, that report can initiate a group search. Perform this function by 
pressing F6 on the key value entry screen (Speciry DocuMENT SEARCH). To search 
multiple reports in the report group, authorize the user to the report group. If the 
user is not authorized to the report group, the prompt Fé = Group Search will not 
be shown on the Speciry DocuMENT SEARCH screen. As a result, the user will be 
unable to start a group search. The group search prompt always displays when the 
user is authorized to the report group. This remains true even though the user is 
excluded from at least one of the individual reports within the report group. 
Performing a group search omits any excluded reports from the scope of the group 
search. Initiating an unauthorized group search by using the FNDKEYRDAR 
command prompts a message from the system. The response will be a more 
specific error message that indicates that the user is not authorized to access this 
report. 


Using Key Security 

The key security function of OnDemand is essentially a required matching of two 
sets of key values: The key values in the report’s index records are compared to 
the key values that are stored in the key security records for that report and user. 
A report's index (or directory) records contain the actual values for each of the 
defined key and display fields. OnDemand extracts these indexes from the actual 
report text when OnDemand archives them. Each of these index records, with its 
combination of key values, points to one particular segment of the report. 


The OnDemand Administrator creates key security records. These records define 
key security values or ranges for particular report segments after the report 
definition is completed and prior to storing the report. Each key security record 
contains the following definitions: 


* A-key security value combination for a particular report name. 


* A particular user (or group of users) authorized to the key security values of 
that report. 


Document Search: An OnDemand user selects specific segments or pages of a 
document (or report) by entering one or more search values on the Speciry 
Document SgARCH screen. Any entered search values are then compared to 
corresponding key field values in the report’s index records. A list of all the index 
records which match both the entered search values and the key security values 
then displays on the Work with Documents screen. Checking search values and key 
security values is always performed for all users for each key or display field. This 
is true only for keys or display fields that have Key security set to Y in the report’s 
definition. Checking security values is not overridden for a user that has *ALLOBJ 
or security officer authority. 


The enhanced key security process initiates: 


* When any key and display field have Key security set to Y in the report 
definition record. 


* The actual values of each of these fields must be within the permitted ranges 
specified in the key security records for that key or display field for that user. 


The search process will display only those index records (key values) which satisfy 
the key security requirements and which match the entered key values. To 
illustrate this, assume a user requests all of the segments of a report by entering 
*ALL as the key 1 search value. That user will actually see a list of those index 
records which key security checking has determined that he is authorized to use. 
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The key security records selected for the current user are chosen with preference 
for the most specific entry in the key security tables. For example, FRED is an 
OnDemand user, and one key security record specifies that FRED can use only 
company numbers 100 through 199 of the report that is named GLEXPENSE. (Use 
the company number as one of the keys for the report.) Another key security 
record for the same key and report name authorizes public (*PUBLIC) to all 
company numbers in GLEXPENSE. Because a more specific record for FRED 
exists, OnDemand uses FRED. He sees only those segments of the GLEXPENSE 
report which have company numbers between 100 and 199. The key security 
record selection order is user profile, user group profile (if the user’s user profile 
specifies any user group profiles), and finally *PUBLIC. 


If a key or display field has key security enabled, and no key security records are 
found which apply to the current user, the search will not be performed. The user 
will receive a message indicating that no documents are found with this key. 


Group Search: A group search is performed when the user selects a report name 
which is part of a report group and then presses Fé on the Speciry DocuMENT SEARCH 
screen. Performing a group search identifies authorized reports within the group, 
selects keys which match specified date ranges, any entered key values, and all key 
security ranges. 


Generating a group search identifies the report group’s key security records. Earlier 
versions of OnDemand used the selected report’s key security records for a group 
search. Now, a group search does not use any of the key security controls for the 
individual reports. This change may produce significant differences in the results 
of group searches as compared with searches that are based on some of the 
individual report definitions. Specifically, a key field remaining defined or not 
secured in the report group definition remains unused for any key security 
checking. Yet this key may be defined and have Key security set to Y in one or 
more of the report definitions within the group. 


Printing Complete Reports (PRTRPTRDAR): The Print Report menu option and 
the PRTRPTRDAR command reprint the complete text of an archived document. 
This is equivalent to retrieving every segment of the document, and therefore, key 
security checking is performed for this function as well. An end user wanting to 
print an entire report in this way must be authorized to *ALL key values for each 
key which has key security enabled in the report definition. If OnDemand fails to 
find such a key security record for any secured key, the requested report will not 
be printed. The command will return an error message indicating that the user is 
not authorized to the particular report. 


The key security records granting access to all key values (where both the low and 
high value fields contain the special value *ALL) may be provided under the 
following conditions. 


* For individual user profiles. 
* For group profiles. 
* For all OnDemand users (*PUBLIC). 


The key security records selected for the current user are chosen with preference 
for the most specific entry. FRED has key security records authorizing him to use 
only specific key ranges for a particular report key. Furthermore, the public 
authorization for that same key is *ALL. This means that FRED will not be able to 
print the report even if he is authorized to use the Print Report menu option or 
PRTRPTRDAR command. 
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Checking for key security records with *ALL in the low and high values is always 
performed for all users for every key or display field. This is true only for keys or 
display fields which have Key security set to Y in the report definition. Key 
security value checking is not overridden because the user has *ALLOBJ or 
security officer authority. 


How to Setup OnDemand Security 


Report Security Administration 

OnDemand manages report security similar to standard OS/400 object security 
functions. OnDemand uses authorization lists to grant and check users’ authority 
to OnDemand report directories and their contents. Because report security is 
similar to standard OS/400 security, an OnDemand user who has *ALLOBJ 
authority will, by definition, also have authority to all objects within OnDemand. 
IBM does not recommend this. 


Security for the OnDemand administrative files and commands contains 
enhancements from previous OnDemand releases. OnDemand secures objects by 
using a new authorization list that is called QRDARSADM. The new user profile 
for OnDemand administrators, which shares the name QRDARSADM, has *ALL 
authority for those objects secured by the authorization list QRDARSADM. To 
allow access to the administrative files and commands, you need to add the 
QRDARSADM user profile as a group profile to each OnDemand administrator’s 
user profile. QRDARSADM can be the first group profile 
(GRPPRF(QRDARSADM)) or any one of the supplemental group profiles 
(SUPGRPPRF(QRDARSADM)). 


The security enhancements described here have not significantly changed actual 
administrative tasks that are required for the following: 


* Report security. 
° The WRKADMRDAR command. 
* The menu options used to edit the report authorization lists. 


The usage of the report group’s authorization list that grants authority to all of the 
reports in the report group has been enhanced from previous releases of 
OnDemand. Assume an OnDemand user has no specific authority entry in a 
particular report’s authorization list, and that report is in a report group. 
Subsequently, the authority granted to that user in the report group’s authorization 
list will apply to the individual report. This is analogous to the use of a user group 
profile to grant authority to certain objects to a group of users. 


For example, when adding a new OnDemand report definition to a report group, 
the new report’s authorization list will have an entry for user *PUBLIC by 
specifying “EXCLUDE. Assume that the report group’s authorization list contains 
an entry which authorizes FRED to use that report group. Then he will also be 
able to use the new report in the group. FRED’s authorization to the report group 
overrides the *PUBLIC *EXCLUDE for the new report. Should the new report’s 
authorization list change by adding an *EXCLUDE entry for FRED, FRED will 
have no access the new report in the group. If he does a group search, it will not 
include the new report. 


Users that are authorized to a report group but explicitly excluded from reports 
within the group may have limited ability to perform a group search. If a user is 
found that is explicitly excluded from more than 20 reports in the group, that user 
will not be able to do a group search. 
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Key Security Administration 

Administering key security involves maintenance activities for two separate types 
of records: Report definition records and key security records. Some of the fields 
and attributes of these records have very similar names and closely related 
functions. This means that careful distinctions between these records and their 
functions are very important. 


Report definition records (found in the file QARLRACT) describe an OnDemand 
report: 

* Its general characteristics. 

* How to divide it into segments. 


* Which key and display fields to use for locating the desired report and segments 
for retrieval. 


Each key and display field in the report definition has a Key security field. Set this 
field to ¥ to turn on key security functions for that particular field. Maintain these 
report definitions by selecting the Work with Report Definitions menu option from 
one of several OnDemand menus. 


Key security records are in a set of files that are named QARLRSECn, where n is 
the number of the key field that is used for key security checking. Each key 
security record specifies a range of permitted values for a particular key/display 
field, report, and user combination. Designate users by user profile, user group 
profile, or *PUBLIC. Maintain these key security records by selecting the Work 
with Key Security menu option from the Report ADMINISTRATION MENU. 


To change or add report definition records or key security records, the 
administrator’s user profile must have the new QRDARSADM user profile 
specified as a group profile. 


Enabling Key Security in Report Definitions: Each key/display field in the 
report definition has a Key security field, which may be set to Y or N. There are 
several significant facts that are related to the setting of these Key security fields. 
The intent is to extend any action that is taken to secure a key or display field to 
all other report definition records that are potentially used to access the same 
report. The following paragraphs describe these changes in detail. 


Enabling Key Security in Report Group Definitions: It is now valid to have Key 
security set to Y for key fields and display fields in a report group definition. 
Adding or removing key security records for the report group’s key or display 
fields will automatically set the Key security values correctly in the report group 
detniagn. (Gee 
[Records”]and ‘Maintaining Key Security Records” on page 133]for additional 


information.) 


Enabling Key Security for Display Fields: It is now possible to enable key security 
for both key and display fields in a report definition. You can select both types of 
fields for entry and updating of key security records. (Gee|’Maintaining Key] 
Becurity Records” on page 133) It is common to designate the same data item as a 
key field in one version of a report definition and as a display only field in another 


version. Key security restrictions should work correctly regardless of which version 
of the report definition gets used for report retrieval. 


Key Security Values Changed by Adding or Deleting Key Security Records: Adding at 


least one key security record for a key or display field for a particular report 
automatically changes the Key security value for that field in the report definition 
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record to Y. Assume that more than one version of the report exists. For example, 
report GLEXPENSE has two versions, so report definitions exist for version 01 and 
version 02. Subsequently, the Key security field changes to Y in all versions. In 
summary, the Key security changes to Y in the report group definition when the 
following conditions exist: 


* The report is part of a report group. 
* The report group definition defines the affected key or display field. 
* Previously setting Key security to N. 


Key security value for a field in the report definition record automatically changes 
to N under the following conditions: 


* The deletion of the last key security record for a key for a particular report. 


* The deletion of the last key security record for a display field for a particular 
report. 


Assume that more than one version of the report exists. For example, report 
GLEXPENSE has two versions, so report definitions exist for version 01 and 
version 02. Subsequently, Key security field changes to N in all versions. If the 
report is part of a report group, deleting the last key security record does NOT 
change the Key security value for that key in the report group definition. 
(Removing key security from this particular key in this particular report does not 
necessarily mean that this key is no longer secured at the report group level.) 


This automatic updating of the Key security values in the report definitions 
actually occurs when the administrator exits from the key security maintenance 
program. Whenever key security records are created for a particular key, an update 
is performed. The program decides that at least one key has been added for a key 
or display field for a particular report if it finds that such a key security record 
exists. Deletion of the last key security record occurred because no key security 
records for that key existed in the selected report. Therefore, this automatic 
updating of key security values in the associated report definitions happens every 
time the administrator exits from the key security maintenance program. This is 
true even if no actual maintenance was performed. 


Changes to Key Security Values Reflected in Other Report Definitions: The Key security 
field changes to Y in all versions whenever the following conditions exist: 


* Change Key security to Y for a key or display field in any report definition. 

* More than one version of the same report exists. 

The changing of Key security to Y also changes it in the definition for the report 
group when meeting the following conditions. 

* The report is part of a report group. 

* The report group definition defines the affected key or display field. 

* Key security was previously N in the report group definition. 


Using Key Security Values from Prior Versions When Adding New Report Definition: 
Assume the administrator is adding a new report definition to OnDemand, and 
another version of the same report exists. The existing version supplies the default 
values for Key security values of the new report definition. Assume there is not 
another version, but the new report definition adds to a report group. Use the Key 
security values from the report group definition record as the default values in the 
new report definition record. 


Key Security Not Permitted for Multiple-value (Multi-key) Fields: When adding or 
changing report definition records, making the Key security and Multi-key values 
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both equal Y for the same key/display field is no longer permitted. Use the 
Multi-key designation when a single segment of a report may contain more than 
one value for that key field. This means that multiple index records that have 
different values for this key field may be used to access the same report segment. 
Assume that key also enabled key security. It is possible to use a permitted value 
for this key to retrieve and view a report segment that contains restricted values. 


The key fields to restrict by key security in a report are not the same keys which 
will normally have multiple values in the same segment. If customer invoices 
archive with key fields that are defined for company, salesman, customer, invoice 
number, and product number, these invoices would probably divide on a change in 
the invoice number. Most of the invoices will contain multiple products, so 
designate product number (key 5) as multi-key. Key security would very likely be 
appropriate for company, salesman, and perhaps the customer number (keys 1 - 3). 
You can enable key security for these keys and designate the product number (key 
5) as multi-key. This means that both key security and multi-key processing will 
work correctly, without the security exposures as described above. 


Maintaining Key Security Records: 


Selecting Report Groups for Key Security Maintenance: The OnDemand report 
administrator, by using key security maintenance (option 13 on the Report 
ADMINISTRATION MENu), can now select a report group name on the Work wITH 
Security ONDEMAND screen. Adding or removing key security records for the report 
group’s key or display fields will automatically set the Key security values 


correctly in the report group definition. (See |“Key Security Values Changed b 
Adding or Deleting Key Security Records” on page 131 


When selecting a report group name, the screen editing functions will require that 
the Version value gets entered. A report group definition has no version value, but 
simply leaving the default value of 01 correctly selects the specified report group 
definition. 


Selecting Display Fields in Key Security Maintenance: You can select both key fields 
and display fields for entry and updating of key security records. 


It is common to designate the same data item as a key field in one version of a 
report definition and as a display only field in another version. Key security 
restrictions should work correctly regardless of which version of the report 
definition gets used for report retrieval. 


Omitting Multi-key Fields in Key Security Maintenance: Potential problems exist with 
enabling key security for multiple-value key fields and display fields. For this 
reason, key/display fields which have Multi-key set to Y are not shown on the 


SELECT Keys For Security screen. This is the screen that lists the key and displa 
fields that are defined in the report definition. See |“Key Security Not Permitted for 
Multiple-value (Multi-key) Fields” on page 132 


Entering Low and High Values in Key Security Records: Entry and update of the low 
value and high value data fields in the key security records are not tightly edited. 
Because these values are based on the actual data values that are extracted from 
archived reports, almost anything is permitted in these fields. However, a few 
items require some special consideration. 


In general, the key security checking process uses exactly what it finds in the low 
and high value fields. So the character position within the field makes a difference. 
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Be careful not to accidentally key value M into the low value field as M (with a 
leading blank). This causes that user not be restricted to key values beginning with 
M. The leading blank in the low value M will probably allow access to all key 
values. 


You can use most special characters in low values and high values without any 
difficulty. This is not true for the single quote mark or apostrophe (’) and the 
percent sign (%). Using either of these special characters in any key security record 
will cause a program failure during report retrieval. 


Two special characters have special functions when used in the low value and high 
value fields, but only when other special conditions are also true. When the 
asterisk (*) is the last character entered, it designates that_a partial value is used in 
a generic comparison of values. (Refer tol Partial Values in Key Security Records 
For Generic Comparisons’ [for detailed information on using this function.) Using 
the underscore (_) in low and high values which are identical, designates_a 
character position which may contain any character. (Refer tol"Key Security Special 


alues to Authorize Access to Specific Data Patterns”|for more information.) 


Enabling key fields for lowercase values in the report definition may require 
additional multiple key security records. All lowercase characters, a through z, are 
lower than the uppercase characters in the standard collating sequence. Any user 
to be authorized to key values from A through K, but the data may be either 
uppercase or lowercase, requires two key security records: One with values A* and 
Ke, and one with a? and Kk, (See 
[Generic Comparisons” | for information on using the asterisk "*" as the "generic" 
indicator.) 


Partial Values in Key Security Records for Generic Comparisons: You can enter partial 
values (fewer characters than required to match the actual key length) into the low 
value and high value fields in key security records. With the enhancements to key 
security, use of these partial values has been extended. You now can choose 
between exact matches and generic searching by adding an asterisk (*) to the 
entered values. 


You can restrict a date field with values such as 06/13/96 by using key security 
values. Simply entering 06 in both the low and high value fields does not allow 
the affected users to retrieve all the entries for that month. Adding an asterisk (*) 
to the value indicates that OnDemand should treat it as a generic value when 
checking key security. (This use of an asterisk to designate that the data entered is 
a partial value is the same technique used to request generic searches values 
during report retrieval.) If the low and high values are 06*, all values beginning 
with 06 will satisfy the key security checking. 


For another example, assume that a report includes department numbers 23 and 
232. OnDemand user FRED should only use records for department 23. Entering 
23 in both the low and high values in his key security record allow him to use 
segments having 23 but not to those with 232. 


Key Security Special Values to Authorize Access to Specific Data Patterns: The typical 
use of the low value and high value fields in the key security records is to define 
an authorized range of key values for the user. The entry of exactly the same value 
in both the low value and the high value fields creates a special case for this range 
checking. In effect, the key security checking process performs a test for values 
which match the single value which appears in both fields. 
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In this special case only, use the underscore character (_) within the entered value 
to represent any single character. If both the low and high values are A_C, the user 
will be authorized for key values ABC, AXC, A4C, and so forth. The user will not 
be authorized for ABX, AB, or ABCD. Adding the generic indicator (A_C*) 
extends access to ABCD, ANC1234, and all other keys having characters other 
than blanks as the fourth and following characters. The key security value A_C* 
specifies that the first character must be A and the third character must be C. All 
other characters may be any SBCS (single-byte character set) character. 


Suppose that the report key to be secured for user FRED is a general ledger 
number like 02.014.nnnnn.nnn. Assume that the 02 portion is a company number, 
014 is a department number for maintenance operations, and the remaining 
numbers are various minor codes. FRED should view only those portions of 
various reports which apply to his own department (014), but he has 
responsibilities for all companies. A key security record with both the low and high 
values set to __.014* will allow FRED to retrieve report segments for only 
department 014. The two underscore characters specify that any two-character 
company number is fine. However, .014 must be matched exactly, and the trailing 
asterisk (*) specifies that any characters are permitted in the remaining positions. 


Use of the underscore character, especially when multiple key security records are 
involved, should be performed only with careful planning and testing. 
Combinations of key security records for the same users having both matching 
values and character substitution and the usual low and high range values can be 
confusing. 


Selecting User Profiles for Key Security Records: Entry and update of the user profile 
field have not been changed from previous releases. The changes to key security 
have corrected some errors in the use of multiple key ranges for the same user, 
especially for the user that is known as *PUBLIC. Additionally, if you have user 
profiles which have more than one group profile, each of the specified group 
profiles will now be checked in the order of their appearance in the user profile. 


The key security records for a particular user will be selected for use by report 
retrieval with a preference for the most specific entry or entries. This selection 
order is user profile, then user group profiles (if the user profile specifies any user 
group profiles), and finally *PUBLIC. If one or more key security records are 
found at any level, the remaining levels are not checked. 


Automatic Updating of Key Security Values in Report Definitions: Add at least one key 
security record for a key or display field for a particular report. Then the Key 
security value for that field in the selected report definition automatically changes 
to Y. 


Now, assume that more than one version of the report exists. (For example, report 
GLEXPENSE has two versions, so report definitions exist for version 01 and 
version 02.) Key security changes to Y in the report definitions for all versions. 


The report group definition changes to Y when the following conditions are met: 
* The selected report is part of a report group. 

* The report group definition defined the added key or display field. 

* Key security value was previously N. 


When the last key security record deletes for a key or display field for a particular 
report, the Key security value for that field in the report definition automatically 
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changes to N. Assume that more than one version of the report exists. (For 
example, report GLEXPENSE has two versions, so report definitions exist for 
version 01 and version 02.) Key security changes to N in all versions. 


If the selected report is part of a report group, deleting the last key security record 
for a particular key or display field does NOT change the Key security value for 
that field in the report group definition. (Removing key security from this 
particular key in this particular report does not necessarily mean that this key no 
longer needs to be secured at the report group level.) 


This automatic updating of the Key security values in the report definitions 
actually occurs when the administrator exits from the key security maintenance 
program. The updating is performed based on the existence of any key security 
records for that particular key. The program decides that at least one key has been 
added for a key or display field for a particular report if it finds that such a key 
security record exists. Deleting the last key security record for a key or display 
field for a particular report occurs when no key security records for that key are 
found in the selected report. Therefore, this automatic updating of Key security 
values in the associated report definitions happens every time the administrator 
exits from the key security maintenance program, even if no maintenance was 
actually done. 


Customizing the Spool File Archive Environment 


OnDemand retrieves stored reports by various users. You can retrieve these reports 
for viewing, reprinting, or faxing. OnDemand stores the various values that control 
these three output operations in data areas. Use the screens that are described in 
“Option 30. Change OnDemand Global Report Options” on page 87 
and 


OnDemand Report Options” on page 93]to set these values. 


New OnDemand enhancements may be released in the future that use control 
values in these data areas that are not yet available for update using the screens. In 
this case, instructions for the enhancement will refer you to a maintenance 
program that can be called directly, passing parameters that correspond to the 
required control values. Descriptions of the layout of these data areas and the 
maintenance program (QRLRSETP) used to update the customization parameters 
are included with your OnDemand software in the QSAMPLES source file in 
library QRDARS, member name PROFILE. 


Additional Spool File Archive Topics 


This section includes a variety of topics that should be considered when putting 
the OnDemand Spool File Archive into use. 


Calculating Line Number 


When you create a report definition in OnDemand, you are asked to provide 
information regarding the horizontal and vertical positions of data on the page of 
data items such as keys (indexes), segmentation values, and report dates. You are 
also asked to specify line numbers when you define report overlays for viewing 
(and possibly printing or faxing). In both report and overlay definitions, the term 
line is used to describe the vertical position of the item being defined, but the 
value for this field is calculated differently for each of these two types of 
definitions. 
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For Report Definitions 

For a report definition, the term line does not refer to the vertical position on the 
page where the line would appear if printed; instead, it refers to the relationship, 
among the records in the spooled file, of each print record (line) to the first print 
record on the same page. For example, consider a customer invoice. The first line 
printed on each page might contain invoice number and date, and would appear 
on line 6 of a form (about an inch from the top of the page) if printed. To 
OnDemand, this data is on line 1 (not line 6), because it is the first line written to 
the page. The line containing customer name is the second line written to the page, 
and although it might appear on line 10 if printed, it is line 2 to OnDemand. (If 
you are using Translate print control set to Y in the Environment section of your 
report definition, then this discussion does not apply. Using the Translate print 
control function causes the report definition line numbers to represent the same 
number as the actual printed line number. This may appear easier to define, but it 
requires OnDemand to take significantly more time to store a report.) 


The recommended approach to determine the line numbers for a standard spooled 
file (nonAFPDS) report definition is to use the Copy Spooled File menu option on 
the Report DerinirioN MENu to copy spooled output from a report for which you are 
creating a report definition. This method creates a database file of print line 
images, one database record for each spooled record (line). By specifying *FCFC 
for the Control character parameter (which is the default when using the 
OnDemand menu option), a forms control character is placed in the first position 
of each database record. Use the Display Physical File Member menu option on the 
Report DerinitioN MENu to view the resulting data base file. Records with a 1 in the 
first position represent the first line of print for a page. To OnDemand, the data in 
this record is on line 1. The records following this record are seen by OnDemand 
as lines 2, 3, 4, and so forth until another record with a 1 in the first position is 
found. Then the line numbering starts at line 1 again. 


For a spooled file that is created as *AFPDS or for OnDemand Report data type 
*SCS, the concepts are similar. However, OnDemand uses another technique to 
determine the line numbers. OnDemand supplies a program which processes a 
spooled file and produces printed output of any text data with horizontal and 
vertical ruler lines added. OnDemand prints the data while ignoring fonts, images, 
and other AFP resources. (You can create this output by using the Print AFP Text 
Data for Report Definition menu option on the Report Derinirion MENu.) Using this 
output, you will be able to determine horizontal (column) and vertical (line) 
positions of the print data. 


For Report Overlays 

Line numbers are also used in report overlay definitions to specify where a line of 
overlay data should be inserted or overlaid when viewing (and optionally 
printing /faxing) an archived report. Unlike the line numbers in report definitions 
described previously, line numbers for report overlays pertain to the line number 
on the printed page where the data would appear if printed. 


The recommended approach to determine these line numbers is to store the report 
within OnDemand as desired, then retrieve it as an end user would (using the 
Retrieve Reports menu option on the Report DEFINITION MENU.). (You could also do 
this by viewing the original spooled file in the output queue.) In the top right 
corner of the Display Spooled File screen, you will see information like this: 
Page/Line 1/2 
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As you advance by pressing Page Down or by entering control commands in the 
Control field at the top left of the screen, you will see the line number changing. 
This is the line number to use when creating or changing report overlays. 


Combined View/Print/Fax 


The report retrieval process in OnDemand includes a sequence of selection steps. 
The user selects a report or report group, then a specific occurrence of that report, 
then key value(s) to be used to select particular segments of the report. When the 
selected key values are displayed on the Work with Documents screen, the user is 
prompted to enter options to select document segments to be viewed, printed, or 
faxed. Use of one or more of the combined view/print/fax options determines 
how multiple choices entered at the same time are processed. 


Combined view/print/fax allows the user to select multiple report segments for a 
particular output operation and have those segments combined into a single 
spooled file prior to performing the output operation. For example, suppose that 
an OnDemand user wishes to transmit copies of three separate invoices to a 
customer via fax. If combined fax is not active for that user, selecting the three 
invoices will start three separate fax transmissions. If the combined fax option is 
active, the three invoices selected at the same time will be combined into one 
spooled file, and this combined file will be sent via one fax transmission. 


The actual output operations work the same way for both combined and 
uncombined selections. Using the combined options appends multiple segments 
into one spooled file. After that spooled file is created, all subsequent operations 
are done without any awareness that the spooled file may contain more than one 
report segment. Therefore, all available viewer programs and the print and fax 
functions work exactly the same way for both combined and uncombined 
selections. 


Combined functions are activated by setting control values in the user defaults 
data area or the global defaults data area. In this way, each OnDemand user has 
independent control of which operations are to produce combined output. The 
global controls provide convenient control points for all users who do not have 
individual options set. The user’s control settings for each of the functions (view, 
print, and fax) will be used if defined; only when the user’s controls have not been 
set will OnDemand use the global controls for that user. All of these controls can 


be set by the profile maintenance screens. (Refer to[“Customizing the Spool File] 
[Archive Environment” on page 136]for details) 

There are separate controls for each of the output functions available (view, print, 
and fax). For example, a user might wish to combine print and fax operations, but 
continue to display multiple selections one-at-a-time. A user can easily tell how his 
control values have been set by reading the option descriptions on the Work with 
Documents screen. He will see 5=Display, 6=Print, and 7=Fax if none of the 
combined settings are active; he will see 5=Combined Display, 6=Combined Print, and 


7=Combined Fax if all of the combined settings are active; or he will see a variety of 
the descriptions if some are active and some are not. 


Because the combine functions add multiple report segments into a single spooled 
file prior to output, there are limitations to selecting and using the combine 
functions. Selected report segments must have compatible print attributes; attempts 
to combine mismatched segments will result in an error message which identifies 
the problem segment. This will only occur when selecting segments from different 
reports. Such selections may occur under two conditions. 
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* After the system performs a report group search. 


* When different versions exist of the same report, and when the print attributes 
have changed from one version to the next. 


A user can select report segments for only one combine function at a time. For 
example, if both print and fax have been defined for combined outputs, either of 
these choices may be used to combine selected segments, but some segments 
cannot be chosen for combined print and others for combined fax prior to pressing 
Enter at one time. Combined view/print/fax allows selecting many report 
segments (up to 255), but these are combined into one spooled file which is then 
used for only one output operation. Selecting single (uncombined) functions ahead 
of a combined set at the same time will work; but uncombined functions which 
follow a set of selections to be combined will result in an error. 


Once several segments have been selected and combined, they cannot be separated 
during that particular output operation. For example, if combined view is active, 
and several report segments have been selected for viewing, the viewed file 
contains all of the selected segments. If the user presses the Attention key during 
viewing, and then selects the option to fax the document, all of the selected 
segments will be included, even if the combined fax option has been set to *NO. 
But if these segments are selected to be faxed by entering multiple 7 options on the 
Work with Documents screen, and the combined fax option is set to *NO, then the 
faxes will be transmitted separately. 


When segments are being selected for multi-key reports, it is quite possible that 
selected key values may result in a particular report segment being retrieved more 
than once. If this occurs, OnDemand will recognize this and include the segment in 
the combined output file only once. 


Usage Statistics Reports 


Your initial estimates for Days allowed on disk, Days allowed on tape, and Days allowed 
on optical for your report archives (defined in the report policy definitions) can be 
modified after OnDemand has collected historical data related to actual usage. 


Issue the following program call on any OS/400 command line while QRDARS is 
in your library list. This generates the reports that show actual activity against each 
report that is defined to OnDemand. 


* CALL ORLRSTAT 


OnDemand generates two reports (with spooled file names QPQUPRFIL). The first 
is titled Access Report by Week; the second is titled Access Report by Month. You 
can use these reports to make educated decisions about the report migration 
characteristics you define in your report policy definitions. 


Audit File Action Codes 


OnDemand Spool File Archive provides an audit file to which a record is written 
each time an action is taken on a report. You can run queries against this file, 
called QARLRAUDIT (in library QUSRRDARS), to provide a wide variety of 
additional management reports about your archives. 


An action code appears in each record to describe the logged activity. The list of 
codes and their meanings are as follows: 


* Dor 5 - Report displayed 
* P or 6 - Report printed 
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* F or 7 - Report faxed 

* I- Report definition imported 

* S - Successful report store 

* U - Unsuccessful report store 

* V - Security violation - not authorized to report 
* Z - Report occurrence deleted 


OnDemand and OS/400 Graphical Access 


This version of OnDemand includes support to enable iSeries users on 
programmable workstations to work with OnDemand screens in a Graphical User 
Interface (GUI) format. If your system provides this capability (referred to as 
OS/400 Graphical Access), you will be able to work with graphical versions of the 
OnDemand screens. This allows you to point-and-click for many of the OnDemand 
functions. OnDemand requires no additional setup. 


OnDemand and iSeries Access AFP Viewer 


OnDemand provides a link to a feature of iSeries Access commonly referred to as 
AFP Workbench Viewer, which allows OnDemand end users on programmable 
workstations to invoke the iSeries Access viewer to display OnDemand documents 
or report segments in a workstation window. The support for this function is 
provided by both OnDemand and iSeries Access. 


The most significant capability of this viewer is that end users can select an AFPDS 
report segment and have a pop-up window presented to view: 


* AFPDS output fully resolved (with fonts; without overlays and PSEGS). 


* AFPDS output fully resolved with associated AFP overlay or PSEG if the 
resource is available to the workstation or on a server disk. 


Note: In all cases, make the AFP resources called out in the document available 
where the viewer can find them -- on the workstation or on a server disk. 
"Normal" fonts are usually available to the viewer. Things like PSEGS and 
OVERLAYS must be on the workstation or on a server disk for the Viewer to find 
them. (The server disk could be space on the iSeries in IFS.) Additionally, the 
viewer may not be able to read an SCS print file and recognize an overlay that is 
named in a printer file. Plan to test SCS data with overlays prior to 
implementation, or consider changing the printer file attribute to *AFPDS to trigger 
iSeries Access to attempt to display the data. If the Viewer is unable to display the 
data for any reason, OnDemand will automatically select an alternate viewer (such 
as Display Spooled File) to display the data. 


To take advantage of this function: 


* Insure that you are using one of the following iSeries Access products and have 
applied the latest Service packs: 


— iSeries Access - Windows 3.1, Windows 95, or Windows NT® 
— iSeries Access - Optimized for OS/2® 


* Use QUSRRDARS to create a data area capable of running the viewer for each 
workstation. Create this data area by issuing the following command: 


— CALL PGM(QRDARS/QRLRSETP) PARM(* VIEWADDWS’ ’/xxxxxxxxx’ ” ’) 


Where ’xxxxxxxxx’ is the workstation name. 
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(If you need to remove this workstation data area later, issue the same call 
above. However, then set the PARM value to *VIEWRMVWS and again specify 
the workstation name you want to remove.) 


* Each user that would like to have the use of the new viewer requires the 
following set up. Their user profile must indicate use of the iSeries Access 
Viewer and specify what kind of data. The iSeries Access Viewer can only 
display *AFPDS and *SCS data. You may choose to let a user view both spooled 
file types or just *AFPDS data. You_can change this profile by using the 
instructions for Viewer Options in|“Option 30. Change OnDemand Global 
Report Options” on page 87}|“Option 31. Change Your OnDemand Repor 
Options” on page 89} or|“Option 32. Change OnDemand Report Options” on 


+ 


Full *SCS Support 


Spooled files that should use the *SCS data type contain variable fonts or other 
extended spool attributes, such as OfficeVision® documents that you can process as 
data type *SCS. OnDemand keeps these attributes for displaying, printing, and 
faxing. 


For most OS/400 spooled files with printer device type *SCS, data type *OTHER is 
appropriate and should still be used. You should only use *SCS as the data type in 
the report definition for those spooled files with extended attributes such as 
variable lines per inch, variable characters per inch, variable fonts, and so on. 


You may choose to try both data types when first defining the report, to determine 
which data type is most appropriate for your particular spooled file data. As you 
experiment, consider the following: 


* *OTHER will often result in better compression than *SCS 


* *OTHER will allow AFP overlays to be applied and displayed in the OnDemand 
Client; *SCS does not 


* *OTHER will allow a user to lock columns and headings using the OnDemand 
Client; *SCS does not 


* *SCS data attributes are all preserved (very important for spooled files with 
attributes described above); *OTHER may not preserve them 


Hints and Tips for Spool File Archive 


This section includes information on a variety of Spool File Archive hints and tips 
for implementation. 


* To determine which output queue your report store statistics appears when 
using the Monitor Output Queue function, simply check the Job description 
parameter on Monitor start-up command. The Output queue parameter of the 
job description determines where the output will go. To change the destination 
to a different output queue, simply change the Output queue parameter in the 
job description or use a different job description when starting the Monitor. 


* When end-users trigger an index or report recall job, the job description that is 
used is ORDARS400 in library QRDARS. However, you can create a data area 
that is called QRLRSBMJOB in library QUSRRDARS to specify an alternate job 
description to use for these jobs. 

Create the data area that is named above as a 20-character data area. The first 
ten positions contain the job description name. The second ten positions contain 
the job description’s library name. The job description name can contain the 
special value *USRPRF, and the library can have the special value *LIBL. 


Chapter 1. Using the OnDemand Spool File Archive Feature 141 


142 


The data area uses a valid job description and library combination, if one exists. 
The data area uses the default if it contains a combination of values that is not 
valid. If it contains *USRPRF special value, then the job description takes the 
user profile of the user who submitted the job. 


When submitting the report store (STRCDSRDAR) and report management 
cycle (STRRMCRDAR) commands to batch, the output, QPRLRCDS, and 
QPRLRRMC remain owned by the user that submits the job. Finding the output 
is then easy, using the OS/400 WRKSPLF (Work with Spooled Files) command 
for the user who submitted the job. 


If you have an output queue that OnDemand uses with the OPRCTL (Operator 
controlled) parameter set to *NO, you must give the QRDARS400 user profile 
*SPLCTL (Spool control) authority. 


When entering a negative number for the +- line offset field in your report 
definition, enter the number and press the Field Minus key. This will enter the 
number as a negative. You may also enter the number followed by the minus 
sign (such as 3-) if you are uncertain what key is your Field Minus key. 


Remember to clear (CLRPFM) the Spool File Archive audit file named 
QARLRAUDIT in library QUSRRDARS periodically. Consider running the 
Usace Statistics Reports (see |“Usage Statistics Reports” on page 139) on a regular 
basis, along with any queries you may choose to write for security audits. After 
running the reports, you can clear the file (after saving it or archiving it with 
OnDemand Object Archive, if desired). 


When considering whether to create a new version of an existing report 
definition or to create an entirely different report definition, remember this: If 
the location of a key or display field changes, you should simply create a new 
version of the same report. An example of this might be if Key 2 was found on 
line 7 but now needs to be changed to line 9 (or to use a pivot value instead of 
an absolute line number). If the meaning of a key or display field changes, you 
should create an entirely new report definition. An example of this might be if 
Key 2 was customer name and it needs to be changed to vendor zip code. If you 
do not follow these recommendations, then the search fields your end users 
enter and the column headings that appear above the items in the report 
selection list will not always correctly describe the data they represent. 


If your application creates individual spooled files for items (such as invoices) 
that you want to store in OnDemand, it is strongly recommended that you do 
not store each one separately. Instead, you should combine the individual 
spooled files into one large file and store the large file in OnDemand. 


There are two significant reasons for this recommendation. 


The first is related to disk space and performance. If you store each item as an 
individual report (sequence number) within OnDemand, you will create a record 
in the Stored Reports Table for each individual item. For 500 invoices per day, for 
example, you would be creating 500 records in the Stored Reports Table each 
day. This approach is clearly not efficient from disk space and performance 
perspectives. 


The second reason is related to the OnDemand maximum number of sequence 
numbers, which is 999. If you need to store more than 999 invoices per day, you 
would reach this maximum, and the OnDemand report store process would fail 
for any reports (invoices) stored after this maximum. 


To avoid the 999 sequence number maximum, you may choose to have 
OnDemand combine multiple report occurrences automatically. To activate this 
function, use the OnDemand administrative tool accessed through iSeries 
Navigator. On the tool’s archive tab you can specify by report whether to 
combine occurrences. 
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DO NOT have the printer files’ Spooled output schedule parameter set to 
*IMMED for applications that create spooled files for processing with the 
Monitor. The monitor considers this an error condition. The monitor then sends 
the spooled file to the output queue specified in the Error output queue 
parameter of the STRMONRDAR command. Without this safeguard, the 
Monitor could attempt to store a spooled file before it was complete and closed. 


If you are using external AFP resources for use with your spooled files, be sure 
to use a different name if you change the resource. For example, if you have an 
AFP resource that contains your company logo, you may one day be asked to 
change to a new logo. You should create a new AFP resource with a new name 
for the new logo and retain the previous AFP resource for the previous logo so 
that OnDemand can find either one when recreating the document. 

Do not start a monitor against an output queue with a writer attached. If you 
do, you run the risk of having a report print before OnDemand stores it. 

Do not start a Monitor against the QRDARS400 output queue. This is the 
default output queue that OnDemand uses for the statistics reports that are 
generated by the report store process. Monitoring this output queue could send 
you into an endless loop of storing reports from stored reports. 
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Chapter 2. Using the OnDemand Object Archive Feature 


The Object Archive feature provides archive and retrieval functions, to and from 
magnetic or optical media, for a large variety of OS/400 objects. This chapter 
includes the screens you use and detailed field explanations. 


As the system administrator, you are responsible for migrating your data to 
OnDemand and for developing standard procedures for your users. Careful 
planning can ensure a smooth transition from your current methods to 
state-of-the-art archiving and retrieval. We suggest that you carefully read Chapter 
4 of IBM Content Manager OnDemand for iSeries Installation Guide before you begin. 


Object Administration Menu 


To Access the Object Administration Menu, you can: 
* Type 2 on the OnDemand for iSeries Main Menu command line,|Figure 186 
¢ Or, use the Fast-Path command: 


GO RDARSOBJ 
on the OS/400 command line, for direct access to|Figure 187 on page 146 


Access the OnDemand for iSeries main menu, |Figure 186 


a 
ONDEMAND OnDemand for iSeries 
System: ONDMD400 
Select one of the following: 


. Report Administration Menu 
. Object Administration Menu 
. Record Archive Menu 

. Media Administration Menu 


PwWNrFr 


90. Signoff 


Selection or command 
S525? 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
F1l6=System Main Menu 
Ce Copyright IBM Corp. 1992, 2000. All Rights Reserved. 


Figure 186. OnDemand for iSeries Main Menu 


Choose option 2 to move to|Figure 187 on page 146 
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RDAROBJ OnDemand Object Administration Menu 
System: ONDMD400 
Select one of the following: 


1. Work with Object Policies 
2. Work with OCT Entries 


10. Edit/Authorize OnDemand Users 


20. Start Archive Objects 
21. Start Retrieve Object 


30. Start Object Management Cycle 


40. OnDemand Main Menu 


Selection or command 
===> 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel  F13=Information Assistant 
F16=System Main Menu 


eo Copyright IBM Corp. 1995, 2000. All Rights Reserved. , 


Figure 187. OnDemand Object Administration Menu 


All of the options on this screen are explained in this chapter; this screen is not 
repeated. 


Option 1. Work with Object Policies 


Use this screen to define the migration and retention characteristics for the archives 
of the OS/400 objects you have chosen, and the number of generations of each 
archive that should be kept. 


Select option 1, Work with Object Policies, from the ONDEMAND Object 
ADMINISTRATION MENU screen, 


Figure 188 on page 147| appears. 
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Work with Admin for OnDemand (WRKADMRDAR) 
Type choices, press Enter. 


Administrator function .... . >*xQ0BJPCY *REPORT, *RPTGRP, *RPTOVL... 
Object: policy: < s csi. 3 Se x *ALL Name, generic*, *ALL... 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
rd 


Figure 188. Work with Admin for OnDemand (WRKADMRDAR) 


Press Enter to continue to the Work witH Object Potictes screen, |Figure 189] Use this 
screen to create, change, delete, or display policy definitions. 


To Create an Object Policy 
Use this screen, to create a policy. 


‘a _ 


Work with Object Policies ONDMD400 
1/31/98 15:50:18 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Option Policy Text 
1 CONNIE 

JOHNS John's Policy 
MARK 
OBJSTORE Default Data Store Archive Policy 
OPTICALO Move to optical right away 
REELO 1/2" Reel tape - 0 days on disk 
TAPEO put on tape immediately 
TBROWN Policy for Terry's data store 


Bottom 


F3=Exit F5=Refresh F12=Cancel 


Figure 189. Work with Object Policies 


Press Enter to continue to the Create Osjecr Pouicy screen,|Figure 190 on page 148 
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Create Object Policy ONDMD400 
1/31/98 15:50:31 
Type choices, press Enter. 
POIIC YS aegesates eckees co Mckee no: os eugene? eee CONNIE _ Name 
Days allowed on disk ......... 0 0-9999999 
Days allowed on tape ......... 0 0-9999999 
Days allowed on optical ........ 730 0-9999999 
Expitre-atitersdays: s acc. 4. tousb ae fue ose 730 1-9999999 
Recalilmetentione s. .< oc ee sa eee 1 0-999 
Tapecmediia: ty peo se Sos. Sete eis eee 
Optical storage group......... RDAROPT_ Name 
Object. generations: «220% 6 «2.5 «5 12 1-99 
MOXIE poe oi ek cere tied pew oe ese e: wen teh betes tee cane Connie's policy keep 12 
generations __ 
F3=Exit F12=Cancel 
Figure 190. Create Object Policy 
Press Enter to move to|Figure 191 
io : 5 i 
Work with Object Policies ONDMD400 
1/31/98 15:51:59 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Option Policy Text 
JOHNS John's Policy 
MARK 
OBJSTORE Default Data Store Archive Policy 
OPTICALO Move to optical right away 
REELO 1/2" Reel tape - @ days on disk 
TAPEO put on tape immediately 
TBROWN Policy for Terry's data store 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Policy created, F5 for Refresh. 


Figure 191. Work with Object Policies 


This screen confirms your addition of the new policy. 


Press F5 to display the addition. 


To Change an Object Policy 


Use this group of screens to change the characteristics of an object policy. 
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fe 
Work with Object Policy ONDMD400 


1/31/98 15:52:02 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Option Policy Text 
2 CONNIE Connie's policy keep 12 generations 

JOHNS John's Policy 
MARK 
OBJSTORE Default Data Store Archive Policy 
OPTICALO Move to optical right away 
REELO 1/2" Reel tape - @ days on disk 
TAPEO put on tape immediately 
TBROWN Policy for Terry's data store 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
rd 
Figure 192. Work with Object Policies 
Press Enter to move to |Figure 193 
a Change Object Policy ONDMD400 *) 
1/31/98 15:52:07 
PONG Yi Barisercen cet Nees rey lee sess avec ns) ruse eee ce “CONNIE 
Type choices, press Enter. 
Days: alilowedion disk « <3 3 5 se ws 0 0-9999999 
Days allowed on tape «2... 6 66 6 ews 0 0-9999999 
Days: allowed: on optical «4.0% 2 730 0-9999999 
EXpPaARes ahi ersidays enc: <6: set eos wee et ee ce 730 1-9999999 
Recalilicretentaont. ieavse <, ieasenpac crave sess estes 1 0-999 
Tapermedtastype: ec. ek at ccneet tances. eee ce 
Optical storage: groups. « 8 os 2 RDAROPT__ Name 
Object generations= <a s: soacson we Oa 13 1-99 
UISb a eatin gre Peg oenep rok er imtcimecmcy ate Three Sorat poe Th a Connie's policy keep 13 
generations __ 
F3=Exit F12=Cancel 
y 
Figure 193. Change Object Policy 
You can change any of the information by typing over it. 
Press Enter to save your changes. 
To Delete an Object Policy 
You can delete an object policy beginning with|Figure 194 on page 150 
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Work with Object Policies ONDMD400 
1/31/98 15:52:45 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Option Policy Text 
4 CONNIE Connie's policy keep 13 generations 
JOHNS John's Policy 
MARK 
OBJSTORE Default Data Store Archive Policy 
OPTICALO Move to optical right away 
REELO 1/2" Reel tape - @ days on disk 
TAPEO put on tape immediately 
TBROWN Policy for Terry's data store 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Figure 194. Work with Object Policies 
Press Enter to continue to|Figure 195 
Ge ; 
Confirm Delete of Policy ONDMD400 
1/31/98 15:52:50 


Press Enter to confirm your choice for 4=Delete. 
Press Fl2=Cancel to return to change your choices. 


POM Gye teratcte snes ower sabe cae re halced ve pease ies CONNIE 
Days allowed coni-disk: <4. 5 8 a es 8s ae ee 3 0 
Days allowed on tape: «<< «3 ws @ % = 3 0 
Days: allowed ‘on optical... 02 02 20 4 3 730 
Expirexatterndaysies 2:c<0: csc a. 2) cee Pipes wee teens 730 
Recall retention: <2 3.372 & 4 we eo es ae : il 
MapexMedaia: types. sca) cr Gone. exc acl aes ea su eas 

Optical storage group. ........ . : RDAROPT 
Object generations «3. i 6% 6. ee 13 


Text 
generations 


F12=Cancel 
\ 


Connie's policy keep 13 


Figure 195. Confirm Deletion of Policy 


If you entered the correct policy, press Enter to move to|Figure 196 on page 151 


If the policy displayed is not the one you want to delete, press F12 to return to the 


previous screen. 
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Work with Object Policies ONDMD400 
1/31/98 15:52:53 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Option Policy Text 
CONNIE Connie's policy keep 13 generations 
JOHNS John's Policy 
MARK 
OBJSTORE Default Data Store Archive Policy 
OPTICALO Move to optical right away 
REELO 1/2" Reel tape - @ days on disk 
TAPEO put on tape immediately 
TBROWN Policy for Terry's data store 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Policy deleted. 
/ 
Figure 196. Work with Object Policies 
This screen verifies that the policy was deleted. 
To Display an Object Policy 
Use this screen, |Figure 197} to view an object policy. 
a 
Work with Object Policies ONDMD400 *) 
1/31/98 15:52:32 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Option Policy Text 
5 CONNIE Connie's policy keep 13 generations 
JOHNS John's Policy 
MARK 
OBJSTORE Default Data Store Archive Policy 
OPTICALO Move to optical right away 
REELO 1/2" Reel tape - @ days on disk 
TAPEO put on tape immediately 
TBROWN Policy for Terry's data store 
Bottom 
F3=Exit F5=Refresh  F12=Cancel y, 


Figure 197. Work with Object Policies 


Press Enter to move to |Figure 198 on page 152 
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Display Object Policy ONDMD400 
1/31/98 15:52:39 


POUTGY: i Se te ee ow et ee ~~ SCONNTE 
Days: allowed) :on disk: 5: fe ee a 0 
Days allowed on tape .........32 0 
Days allowed on optical < . . 2s < « «4 730 
Expirecatiten days: s29 oe Ao ice es ance : 730 
Recallleretention: “5.8 22. ace ef a 1 
Tape ‘media: type: we sie soe we Re weer 8 

Optical storage group. ...... .. : RDAROPT 
Object generations: Gs. < ioe se 8 13 
MOXIE sey e6P eyes ete ve Ba ee Gh ee hu ities eens LCONNTE +S: policy keep 13. 
generations 


Bottom 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 198. Display Object Policy 
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Use this option to create, change, delete, or display object control table records. 


Records from this table are selected when you archive an object, based on the 
object name (or generic object name) and library you specify. The entry identifies 
the policy that has the storage migration and retention characteristics for that 
archive. 


Use this screen to list details about the objects that will be archived by the Object 
Management Cycle. 


To begin, select option 2, Work with Object Control Table, from the ONDEMAND 
Osyect ADMINISTRATION MENu screen, |Figure 187 on page 146 
The screen, Work wiTH ADMIN FOR ONDEMAND (WRKADMRDAR), that is shown in 


Figure 199 on page 153) appears. 
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Work with Admin for OnDemand (WRKADMRDAR) 
Type choices, press Enter. 


Administrator function . ... . >*0CT *REPORT, *RPTGRP, *RPTOVL... 
OCT library» << sows SS: *ALL Name, generic*, *ALL... 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 199. Work with Admin for OnDemand (WRKADMRDAR) 


Press Enter to continue to|Figure 200} Use this screen to create, change, delete, or 
display object control table records. 


To Create an Object Control Record 
To create an object control table record, use 


~ _ 


Work with OCT Entries ONDMD400 
1/31/98 16:29:29 


Type options, press Enter. 
1=Create 2=Change 4=Delete 


Opt Library Object Type Policy 
1 CONNIE 
*ALL *ALL *ALL OBJSTORE 
JOHNSLIB *ALL *PGM JOHNS 
MARKLIB *ALL *ALL MARK 
QRDARS400 *ALL *ALL JOHNS 
QON 


Bottom 


F3=Exit F5=Refresh F12=Return 


ee sss 


Figure 200. Work with OCT Entries 
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Press Enter to continue to the Create Osjecr Contrrot Recorp screen, |Figure 201 


ve 
Create Object Control Record ONDMD400 >) 
1/31/98 16:29:35 
Type choices, press Enter. 
Object Mibranye ws. eB N eae CONNIE _ Name, *ALL 
ODGECE. aes 1 aw et oe eee *ALL Name, generic*, *ALL 
ODFeGt ty Dee kscs) Giass os emcee cs *ALL Type, *ALL 
BOUICYS cee cet besten eraser “sete Gee oe) ve CONNIE _ Name 
F3=Exit F12=Cancel 
oA 
Figure 201. Create Object Control Record 
Press Enter to move to|Figure 202 
Va 
Work with OCT Entries ONDMD400 ) 
1/31/98 16:29:48 
Type options, press Enter. 
1=Create 2=Change 4=Delete 
Opt Library Object Type Policy 
*ALL *ALL *ALL OBJSTORE 
JOHNSLIB *ALL *PGM JOHNS 
MARKLIB *ALL *ALL MARK 
QRDARS400 *ALL *ALL JOHNS 
QRDARS400F = *ALL *ALL OBJSTORE 
TBROWN *ALL *ALL OBJTEST 
Bottom 
F3=Exit F5=Refresh F12=Return 
Object Control record created, F5 for Refresh. 


Figure 202. Work with OCT Entries 


This screen confirms your addition of an object control record. 


Press F5 to display the addition. 
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To Change an Object Control Record 
Use this screen, to change a record. 


i 
Work with OCT Entries ONDMD400 *) 


1/31/98 16:29:51 
Type options, press Enter. 
1=Create 2=Change 4=Delete 


Opt Library Object Type Policy 
*ALL *ALL *ALL OBJSTORE 

2 CONNIE *ALL *ALL CONNIE 
JOHNSLIB *ALL *PGM JOHNS 
MARKLIB *ALL *ALL MARK 
QRDARS400 *ALL *ALL JOHNS 
QRDARS400F = *ALL *ALL OBJSTORE 
TBROWN *ALL *ALL OBJTEST 


Bottom 
F3=Exit F5=Refresh F12=Return 
Figure 203. Work with OCT Entries 
Press Enter to continue to|Figure 204 
jaa 
Change Object Control Record ONDMD400 3 


1/31/98 16:29:55 
Type choices, press Enter. 


Object. library ess. te aes CONNIE Ss Name, *ALL 

ODGECEN ere ce esmce: cone. cas eee *ALL Name, generic*, *ALL 
ObJeCEREY DOs eves ces) ca isn neue *ALL Type, *ALL 

POMC Yar o's vss sey tages: wl cat vs) Peet eas CONNIE2  ~—— Name 


F3=Exit F12=Cancel 


Figure 204. Change Object Control Record 


Type your new data over the information that appears, and press Enter to move to 
Figure 205 on page 156 
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Work with OCT Entries ONDMD400 
1/31/98 16:29:57 
Type options, press Enter. 
1=Create 2=Change 4=Delete 


Opt Library Object Type Policy 
*ALL *ALL *ALL OBJSTORE 
CONNIE *ALL *ALL CONNIE2 
JOHNSLIB *ALL *PGM JOHNS 
MARKLIB *ALL *ALL MARK 
QRDARS400 *ALL *ALL JOHNS 
QRDARS400F = *ALL *ALL OBJSTORE 
TBROWN *ALL *ALL OBJTEST 


Bottom 


F3=Exit F5=Refresh F12=Return 
Object Control record changed. 


Figure 205. Work with OCT Entries 


This screen confirms your changes. 


To Delete an Object Control Record 


Use this screen, |Figure 206 on page 157} to delete an Object Control Table entry. 


NOTE: There are no edits that prohibit you from deleting an OCT entry for objects 
that have been archived. The OCT entry is only used during the archive process 
(not during the retrieve process). However, it is recommended that you do not 
delete an OCT entry if there are objects archived using that entry. Deleting the 
entry removes the visibility you have to the objects that have been archived, and 
the Policy used for the archive process. 
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(~ Work with OCT Entries ONDMD400 =) 
1/31/98 16:30:06 
Type options, press Enter. 
1=Create 2=Change 4=Delete 


Opt Library Object Type Policy 

*ALL *ALL *ALL OBJSTORE 

4 CONNIE *ALL *ALL CONNIE2 
JOHNSLIB *ALL *PGM JOHNS 
MARKLIB *ALL *ALL MARK 
QRDARS400 *ALL *ALL JOHNS 
QRDARS400F = *ALL *ALL OBJSTORE 
TBROWN *ALL *ALL OBJTEST 


Bottom 
F3=Exit F5=Refresh F12=Return 
se eA 
Figure 206. Work with OCT Entries 
Press Enter to move to |Figure 207 
ie 
Confirm Delete of OCT Record ONDMD400 S 
1/31/98 16:30:10 
Press Enter to confirm your choice for 4=Delete. 
Press Fl2=Cancel to return to change your choices. 
Object Wibrary i... we eee EONNTE 
ObIECt oie ee we ees wee eee ALL 
ObJEGE tyne. wo ese, en bets RAL 
POGY oc ic cep pak oe use) ey cy cette 20) IGONNEE 
F12=Cancel 
SS ey 


Figure 207. Confirm Delete of OCT Record 


If the object control record you are viewing is not the record you want to delete, 
press F12 to return to the previous screen. 


If the object control record is the correct one, press Enter to delete it and move to 
Figure 208 on page 158 
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e ~ 


Work with OCT Entries ONDMD400 
1/31/98 16:30:12 
Type options, press Enter. 
1=Create 2=Change 4=Delete 


Opt Library Object Type Policy 
*ALL *ALL *ALL OBJSTORE 
CONNIE *ALL *ALL CONNIE2 
JOHNSLIB *ALL *PGM JOHNS 
MARKLIB *ALL *ALL MARK 
QRDARS400 *ALL *ALL JOHNS 
QRDARS400F = *ALL *ALL OBJSTORE 
TBROWN *ALL *ALL OBJTEST 


Bottom 


F3=Exit F5=Refresh F12=Return 
Object Control record deleted. 


Figure 208. Work with OCT Entries 


This screen confirms that the object control record is deleted. 


Press F5 to view the list of remaining records. 


Option 10. Edit/Authorize OnDemand Users 
See for these 


procedures. 


Option 20. Start Archive Objects 


You can use this option to compress and archive OS/400 objects. This saves the 
object or objects in a compressed archive on disk, ready for future management by 
the Object Management Cycle. The Object Management Cycle uses the object 
policy criteria of the archive to control its movement from disk to optical media or 
tape. 


To begin, choose option 20, Start Archive Objects, from the ONDEMAND Object 
ADMINISTRATION MENu,|Figure 187 on page 146} The Start ARCHIVE OpjEcTs COMMAND 


(STRARCRDAR) screen, |Figure 209 on page 159} appears. 
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a ~ 


Start Archive using OnDemand (STRARCRDAR) 
Type choices, press Enter. 
DWE Cities x: st en a esaeee ecto ies ey canes ef Name, generic*, *ALL 
[ND GaIGy:. vente oor eo hot tereee: es ean tbrown__ Name 
Object type: ss t2s0 e  ere *ALL *ALL, *ALRTBL, *BNDDIR... 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys y, 
Figure 209. Start Archive using OnDemand (STRARCRDAR) 
Press F10 for additional parameters in |Figure 210 
a ; : es 
Start Archive using OnDemand (STRARCRDAR) 
Type choices, press Enter. 
OD ASCE: ey res seu econ ero we etal Gee cve cs >F Name, generic*, *ALL 
EIB RARY > soi te: se: wey bostese Moh er oe cet Rath >TBROWN__ Name 
ObyeGt. type: sus scenee oe certs *ALL *ALL, *ALRTBL, *BNDDIR... 
Additional Parameters 
StOrdgGar porte eer *KEEP *KEEP, *FREE 
Detail cavcevsaaaayyen alc tcee wats *BASIC *BASIC, *FULL 
Text: “descriptions =.) 2.6 2 ees. Archive all objects in library TBROWN called 
F 
RESTO conse et wow ere oe ae *NO_ *NO, *YES 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
J 


Figure 210. Start Archive using OnDemand (STRARCRDAR) - Additional Parameters 


Press Enter for OnDemand to compress and store an archive of the object or 
objects on disk. You must run the Object Management Cycle for OnDemand to 
migrate the archive to optical or tape, based on the policy name in the Object 
Control Table. 


It is important to understand that the Start Archive using OnDemand 
(STRARCRDAR) function also determines when to remove a generation of an 
object. It looks at the number of times that object becomes archived using only that 
policy. The OBJ, LIB, and OBJTYPE parameters of this command and the 
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definitions in the Object Control Table (OCT) determine the policy. For more 


information about the relationship between the OCT and this command, see[“How] 
(OnDemand Selects a Record from the OCT for an Archive” on page 162) 


Option 21. Start Retrieve Object 
To retrieve an OnDemand archived object, select_option 21, Start Retrieve Object, 
on the ONDEMAND Osject_ADMINISTRATION MENu,|Figure 187 on page 146} The Start 


RETRIEVE OBjEctT screen, |Figure 211} appears. 


a x 


Start Retrieve using OnDemand (STRRTVRDAR) 
Type choices, press Enter. 
ODI Cites eco tee teas F Name 
Archived library. ....... TBROWN__ Name 
Object: type: <2 2 4 4a | ws *ANY *ANY, *ALRTBL, *BNDDIR... 

Bottom 

F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 211. Start Retrieve using OnDemand (STRRTVRDAR) 


Press F10 to move to|Figure 212 on page 161 
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é . 


Start Retrieve using OnDemand (STRRTVRDAR) 


Type choices, press Enter. 


Dye Ct i. ces rene sores soto es cones >F Name 
Archived) library ws Sens es >TBROWN__ Name 
Object=type: “se ea ee eck *ANY *ANY, *ALRTBL, *BNDDIR... 


Additional Parameters 


Generation « «se « & «we a *CURRENT_ *CURRENT, 0 to -98 

(0}o} en la) dies oeseerpecriaae ee armenia ar *NEW_ *NEW, *OLD, *FREE, *ALL 

PaPSMeMDEM sok wun. eee ae *ALL Name, generic*, *ALL, *NONE 
+ for more values 

Database member option. .... *MATCH *MATCH, *ALL, *NEW, *OLD 

Allow object differences .... *NONE *NONE, *ALL 

Retrieve to library ...... QTEMP___ Name, *LIB 

Retrieve to ASP. os sss 5 else *ARCASP 1-16, *ARCASP 

Delete save file . ss 6 we me Ges *OMC__ *OMC, *IMMED 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 212. Start Retrieve using OnDemand (STRRTVRDAR) 


This screen confirms the first three fields you entered, and allows you to further 
define your retrieval. 


Press Enter to start the retrieve process. 


Option 30. Start Object Management Cycle 
To begin the Object Management Cycle, select option 30, Start Object Management 
Cycle, on the ONDEMAND Object ADMINISTRATION MENU, |Figure 187 on page 146] This 
screen, |Figure 213} appears. 


( : > 
Start Object Management Cycle (STROMCRDAR) 


Type choices, press Enter. 


Submit; to: batch) js. 5.0 0s as *YES *YES, *NO 
Jobisdeseniptiomi “i 2. Ae ee ie ee ee QRDARS400_ Name 
[ileal ™ cisoesewse ben saat tes ee eae ires *LIBL Name, *LIBL, *CURLIB 


Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


————— EE EEE EEE aS 


Figure 213. Start Object Management Cycle (STROMCRDAR) 
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Press ENTER to start the Object Management Cycle. OnDemand generates report, 
QPRLOOMC, which provides details of the migration and expiration of archived 
objects. 


Option 40. OnDemand Main Menu 


Select this option to return to|Figure 186 on page 145 


Additional Object Archive Topics 


This section includes a variety of topics that should be considered when 
implementing OnDemand Object Archive. 


How OnDemand Selects a Record from the OCT for an 
Archive 


OnDemand Object Archive creates one *SAVF object to contain the set of archived 
objects for each archive request. This is true provided the request selects a menu 
option from the Osject ADMINISTRATION MENu or issues the STRARCRDAR 
command. OnDemand selects the entry from the Object Control Table (OCT) which 
is the least generic but still satisfies the archive request. 


Consider the OCT Entries in|Figure 214 


(- Work with OCT Entries ONDMD400 ) 


1/31/98 16:29:29 
Type options, press Enter. 
1=Create 2=Change 4=Delete 


Opt Library Object Type Policy 
*ALL *ALL *ALL OBJSTORE 
JOHNSLIB *ALL *PGM JOHNS 
LANDRUM *ALL *ALL ALLCOLL 
LANDRUM *ALL *FILE FILECOLL 
LANDRUM *ALL *PGM PGMCOLL 
LANDRUM PAY* *ALL ALLCOLL 
LANDRUM PAY* *PGM PGMCOLL 
MARKLIB *ALL *ALL MARK 
QRDARS400 *ALL *ALL JOHNS 
QRDARS400F = *ALL *ALL OBJSTORE 
TBROWN *ALL *ALL OBJTEST 
Bottom 
F3=Exit F5=Refresh F12=Return 
XX 24 


Figure 214. Work with OCT Entries 


Using the OCT Entries in [Figure 214] review the following table and the notes that 
correspond to each. Clearly understanding the selection process is critical to 
defining the correct Object Archive environment for your system. The least 
confusing approach would be to eliminate all overlapping OCT Entries, but in 
some cases that may not be possible. 
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Table 1. Specified in STRARCRDAR 


Library Object Type 

LANDRUM *ALL *ALL 

LANDRUM AR* *PGM 

LANDRUM PAY204 *ALL 

LANDRUM *ALL *CMD 

LANDRUM PAY* *PILE 

Table 2. OCT Entry used for Archive 

Library Object Type Notes 

LANDRUM *ALL *ALL 1 

LANDRUM *ALL *PGM 2 

LANDRUM PAY* *ALL 3 

LANDRUM *ALL *ALL 4 

LANDRUM PAY* *ALL 5 

Notes: 

1. The request exactly matches an OCT entry. 

2. The *ALL *PGM OCT entry is less generic than *ALL *ALL for archiving a 
*PGM object. 

3. Even if PAY204 is a *PGM object, the PAY* *PGM entry will not be selected 
because OnDemand cannot assume that there are not other objects in the 
library with the name PAY204. 

4. There is no entry which specifies *CMD as an object type. 

5. In this case, the *ALL *FILE and PAY* *ALL entries are not exact matches for 


the request. The object name becomes the deciding factor. 


Audit File Details 


OnDemand Object Archive provides an audit file to which a record is written each 
time an action is performed on an archived object. It is possible to run queries 
against this file, called QARLOAUDIT in library QUSRRDARS, to provide a wide 
variety of additional management reports about your archives. 


An action code appears in each record to describe the logged activity. The list of 
codes and their meanings are as follows: 


e A - Archive created 
e R- Archive retrieved 


Z - Archive deleted 


Hints and Tips for Object Archive 


This section includes information on Object Archive hints and tips for 
implementation. 


Remember to clear (CLRPFM) the Object Archive audit file named 
QARLOAUDIT in library QUSRRDARS periodically. Consider running a query 
against it on a regular basis if desired. After running the report, you may clear 
the file (after saving it or archiving it with OnDemand Object Archive, if 
desired). 
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* It is recommended that you create separate Storage Groups for Spool File 
Archive, Object Archive, and Record Archive optical data. Different requirements 
exist for each of the OnDemand environments, and it is best to keep the data 
separated. 
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| Chapter 3. Using the OnDemand Record Archive Feature 


Record Archive provides commands and application programming interfaces 
(APIs) that let you store and retrieve data records on optical media for users who 
only require occasional access to historical data. At Version 5 Release 2, this 
product option is provided for existing Record Archive customers to use, but there 
are no planned enhancements. Documentation can be found in OnDemand 
publications from previous releases. Please talk to your software provider about 
other options, such as compressed DASD. 
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Chapter 4. Using the OnDemand AnyStore Feature 


The AnyStore feature provides application programming interfaces (APIs) that let 
you store and retrieve a wide variety of data types on disk, optical, or tape media. 
These data formats store and retrieve (write and read) without regard to the data 
type. AnyStore preserves the format of the data during archive and retrieval. The 
data returned from the archive is in its original form that it was prior to storing. 


Using the APIs provided, you can develop an entirely new application or 
significantly enhance an existing application to store data such as listed below: 


* PC files 

* Entire spooled files 

* Individual database file members 

* Data that is created in a buffer in your program 


You design an application to store the data and an application to retrieve the data. 
AnyStore provides the programming tools (APIs), and OnDemand Spool File 
Archive provides the storage management functions that move the data between 
the different media. 


This chapter includes the detail on the AnyStore APIs to use in your application 
programs. 


Characteristics of AnyStore 
In some ways, AnyStore data is handled in a manner similar to OnDemand Spool 
File Archive data: 
° Keys can retrieve it. 
* It fits into the OnDemand storage hierarchy just like Spool File Archive data. 
* Many Spool File Archive commands can be used for administration of AnyStore. 


It is, however, different from Spool File Archive data in that: 

* It cannot be stored or retrieved using Spool File Archive commands. 
* It can be stored and retrieved via the AnyStore APIs. 

* OnDemand always stores AnyStore data within a report group. 


Defining an AnyStore Report 


You define an AnyStore item by using the Spool File Archive menu option entitled 


WORK WITH REPORT DEFINITIONS or_using the Spool File Archive command 
WRKADMRDAR TYPECREPORT). See[’Option 4. Work with Report Definitions”| 
for more detail about this function. (You will refer to AnyStore items as 
reports” regardless of what type of data actually stores. AnyStore builds on the 
Spool File Archive feature of OnDemand. Report name, report type, (and so forth), 


drive this feature.) 


The Report Definition for AnyStore data REQUIRES the following information: 
* Report type 
— ANYS An AnyStore report 
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* Report data type (select one of the following) 
— *SPLF (each segment is a whole spooled file) 
— *FILE (each segment is all records in a database file member) 
— *BUFFER (each segment is from a buffer in your program) 
— *IFS (each segment is an Integrated File System (IFS) file) 
* Compression 
— ¥ (yes) 
— N (no) 


In addition to the report definition, define the following items for the AnyStore 
environment: 


* REPORT GROUP 

* POLICY 

* STORAGE GROUP (if optical is used) 

* TAPE DEVICE(f tape is used) 

* OPTICAL OR TAPE INVENTORY (as appropriate) 


Deleting an AnyStore Report 


You delete an AnyStore item by using the Spool File Archive menu option that is 


entitled DELETE REPORT or using the Spool File Archive command 
DLTRPTRDAR. See|“Option 3. Delete Report” on page 73} for more detail about 


this function. 


Using AnyStore 


You can store or retrieve AnyStore items by calling an AnyStore Application 
Programming Interface (API) from your High Level Language (HLL) program. 


Sample store logic that uses AnyStore APIs: 


1. Use Open AnyStore Object (QrisOpenAnyStoreObject) API to access 
AnyStore file handle. The file handle is used in both the write and close to 
identify the AnyStore object being used. 


2. Use Store AnyStore Segment (OrlsStoreAnyStoreSegment) API to write data 
into the AnyStore object. 


3. Use Close AnyStore Object (QrisCloseAnyStoreObject) API to close the 
AnyStore object. 


Sample retrieve logic that uses AnyStore APIs: 


1. Use Retrieve AnyStore List (QrlsRetrieveAnyStoreList) API to receive a list of 
available segments that meet specified key values. 

2. Use Retrieve AnyStore Segment (OrlsRetrieveAnyStoreSegment) API to 
retrieve one of the segments from the Retrieve AnyStore List 
(OrlsRetrieveAnyStoreList) API list. 


The QSAMPLES source file in library QRDARS contains sample COBOL and RPG 


programs that use these APIs. The sample source code member names all start 
with QRLSASxxxx. 
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OnDemand AnyStore APIs 


This section describes the AnyStore APIs which allow you to perform the following 
functions: 


* Open an AnyStore object 

* Store an AnyStore segment 

* Close an AnyStore object 

* Retrieve a list of AnyStore segments 
* Retrieve a specific AnyStore segment 


Each API has a fixed number of parameters to pass. OnDemand controls errors are 
controlled through the error code parameter except in the case where an escape 
message is sent to stop the call due to any of the following: 


* There is no room to return the error code. 
* The error is definitional and requires a recompilation of the program. 
* The error is not dependent on the result of the API. 


Error Code Parameter 


All OnDemand AnyStore APIs include an error code parameter that returns error 
codes and exception data to the calling application. The error code parameter is a 
variable length structure that contains the information that is associated with an 
error condition. The error code parameter can be one of two variable-length 
structures, format ERRC0100 or ERRCO0200. 


In format ERRCO0100, one field in that structure is an INPUT field. It controls 
whether an exception returns to the application or the error code structure is filled 
in with the exception information. When the Bytes provided field exceeds or 
equals 8, the rest of the error code structure fills in with the OUTPUT exception 
information that is associated with the error. When the Bytes provided field is 0, 
all other fields are ignored, and an exception returns. 


Use the format ERRC0200 if the API caller wants convertible character (CCHAR) 
support. Format ERRC0200 contains two INPUT fields. The first field, that is called 
the Key field, must contain a -1 to use CCHAR support. When the Bytes provided 
field exceeds or equals 12, the rest of the error code structure fills in with the 
OUTPUT exception information that is associated with the error. When the Bytes 
provided field is 0, all other fields are ignored, and an exception returns. 


Note: To determine if an error occurred, you should check to see if the Bytes 
available is greater than 0. Checking for a non-blank value in the exception 


id is not a valid method. 


The structure of the error code parameter is as follows, depending on the format 
used: 


ERRCO0100 Format: 


Offset 

Dec | Hex | Use Type Field 
0 0 |INPUT | Binary(4) Bytes provided 
4 4 |OUTPUT| Binary(4) Bytes available 
8 8 |OUTPUT| Char(7) Exception ID 
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Offset 
Dec | Hex | Use Type Field 
15 F |OUTPUT| Char(1) Reserved 
16 | 10 | OUTPUT] Char(*) Exception data 


ERRC0200 Format: 


Offset 
Dec | Hex | Use Type Field 

0 INPUT | Binary(4) Key 

4 INPUT | Binary(4) Bytes provided 

8 OUTPUT] Binary(4) Bytes available 

12 | C |OUTPUT| Char(7) Exception ID 

19 | 13 | OUTPUT] Char(1) Reserved 

20 | 14 )OUTPUT| Binary(4) CCSID of the CCHAR 
data 

24 | 18 ) OUTPUT Binary(4) Offset to the exception 
data 

28 | 1C ) OUTPUT Binary(4) Length of the exception 
data 

OUTPUT | Char(*) Exception data 


ERRC0200 field descriptions 


Bytes available 


The length of the error information available to the API, in bytes. If this is 
0, no error was detected. 


Bytes provided 


The length of the area that the calling application provides for the error 
code. If the API caller is using format ERRC0100, the bytes provided must 
be 0, 8 or more that 8. If the API caller is using format ERRC0200, key the 
bytes provided must be 0, 12, or more than 12. 


0 — If an error occurs, an exception is returned the application to indicate 
that the requested function failed. 


>8 — If an error occurs, the space is filled in with the exception 
information. No exception is returned. This only occurs if format 
ERRCO100 is used. 


>12 — If an error occurs, the space is filled in with the exception 
information. No exception is returned. This only occurs if format 
ERRC0200 is used. 


CCSID of the CCHAR data 


The coded character set identifier (CCSID) of the convertible character 
(CCHAR) portion of the exception data. The default is 0. 


0 — The default job CCSID. 


Exception data 


A variable-length character field containing the substitution text for the 
exception. You can use the SNDPGMMSG or SNDUSRMSG CL commands 
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to send a message to someone by specifying the exception id as the value 
for the MSGID parameter and the exception data as the value for the 
MSGDATA parameter on these commands. Messages can also be sent 
using the Message Handler APIs. 


Exception ID 
The identifier for the message for the error condition. Ids that start with 
RDR can be found in the message file QRLCMSGF in library QRDARS. 


Key The key value that enables the message handler error function if CCHAR 
support is used. This value should be -1 if CCHAR support is expected. 


Length of the exception data 
Length of the exception data. The length, in bytes, of the exception data 
returned in the error code. 


Offset to the exception data 
Offset to the exception data The offset from the beginning of the error code 
structure to the exception data in the error code structure. 


Reserved 
A 1-byte reserved field. 


Close AnyStore Object (QrisCloseAnyStoreObject) API 


Parameters 


Required Parameter Group: 

1 AnyStore handle Input Char(16) 
2 Error code 1/O Char(*) 
Service program: QRLSAS1 


Threadsafe: No. 


The Close AnyStore Object (QrisCloseAnyStoreObject) API closes the specified 
object, releasing any locks on the object. The data that is associated with this object 
is forced to nonvolatile storage. 


Attention: Failure to close an object when storing segments to it may leave the 
object in a damaged state. Be sure to always close your object. 


Alternately, call the Program QRLRCASO instead of using 
QrisCloseAnyStoreObject. IBM provided QRLRCASO for compatibility with 
previous AnyStore releases. 


Authorities and Locks 
Library Authority 

*Execute 
Required Parameter Group 


AnyStore handle 
INPUT; CHAR(16) The handle returned when the object in the process of 
closing was opened with the Open AnyStore Object 
(OQrlsOpenAnyStoreObject) API. 


Chapter 4. Using the OnDemand AnyStore Feature 171 


Error code 
I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 169 
Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3CF1 
Error parameter is not valid. 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3. 


RDR2101 
AnyStore handle not valid. Reason code &1. 


RDR2102 
Close failed. 


RDR2103 
Close problem. 


RDR2153 
Unable to obtain proper license. 


Open AnyStore Object (QrisOpenAnyStoreObject) API 


Parameters 


Required Parameter Group: 


1] AnyStore handle Output Char(16) 
2| Report name Input Char(10) 
3 | Version Input Char(2) 
4 | Posting date Input Char(10) 
5 | Run comment Input Char(50) 
6 | Sequence number Output Char(3) 
7 | Error code 1/O Char(*) 


Service program: QRLSAS1 


Threadsafe: No. 


The Open AnyStore Object (QrlsOpenAnyStoreObject) API opens an AnyStore 
object. 


Alternately, call Program QRLROASO instead of using QrlsOpenAnyStoreObject. 
IBM provided QRLROASO for compatibility with previous AnyStore releases. 


Note: Only one AnyStore object can be open at a time within a single job. An open 
AnyStore object must be closed using the Close AnyStore Object API before 
opening another AnyStore object. 

Authorities and Locks 


Library Authority 
*CHANGE 
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File Authority 
*Change 


Required Parameter Group 


AnyStore handle 
OUTPUT; CHAR(16). An identifier made up of arbitrary characters that are 
assigned by the API and used to refer to the AnyStore object in subsequent 
operations. This handle uniquely identifies the open of an AnyStore object. 
Another open of the same report within the same job provides another unique 
AnyStore handle and another AnyStore object. 


Report name 
INPUT; CHAR(10) The name of the report definition to use when opening this 
AnyStore object. 


Version 
INPUT; CHAR(2) The version, in combination with the report name, specifies 
the specific report definition to use. 


Posting Date 
INPUT; CHAR(10) The date to use when storing this AnyStore report object. 
The valid values for this parameter are: 


*JOBDATE 
Use the job date. 


*SYSDATE 
Use the system date. 


Date Enter a date in the format of YYYYMMDD. 


Run Comment 
INPUT; CHAR(50) Text to describe this open. Providing no text defaults to the 
report description. 


Sequence number 
OUTPUT; CHAR(3) A three position character value that indicates the 
sequence number that is assigned this run. The sequence number denotes 
different runs of the same report for a specific date. The maximum number of 
runs for a single report for a specific date is 46,656. The sequence number 
resets for each new date and is report specific. 


Error code 
I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 169 


Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3CF1 
Error parameter is not valid. 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3. 


RDR2153 
Unable to obtain proper license. 


RDR2201 
No report found. Reason code is &1. 
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RDR2202 
Run date is not a valid date. 


RDR2203 
New sequence number can not be assigned. 


RDR2204 
Open failed. 


RDR2205 
Authority-insufficient. 


RDR2206 
Report name or version blank. 


RDR2207 
Run date parameter is not valid. 


RDR2208 
Report processing already in progress. 


RDR2209 
Document Library Services open problem. 


RDR2211 
Open problem. Reason code is &1. 


Retrieve AnyStore List (QrisRetrieveAnyStoreList) API 


Parameters 


Required Parameter Group: 


1| Receiver variable Output Char(*) 

2| Length of receiver variable | Input Binary(4) 

3| Receiver variable format | Input Char(8) 
4 | From segment key Input Char(*) 

5 | To segment key Input Char(*) 

6 | Segment key format Input Char(8) 

7 | Maximum segments to Input Binary(4) 

retrieve 
8 | Continuation handle Input Char(16) 
Omissible Parameter Group: 

9 | Request index status Input Char(10) 
10 | Index status Output Char(1) 
11 | Error code 1/O Char‘(*) 


Service program: QRLSAS2 


Threadsafe: No. 


The Retrieve AnyStore List (QrlsRetrieveAnyStoreList) API retrieves a list of all 
segments that match the keys specified. Generic and range searches are allowed. 
Following the key value with an asterisk (*) signifies a generic search. Specifying 
more than one key causes the search to perform in the listed order that the keys 
appear in the segment key parameter. Specify at least one key. If a key field is 
blank, it is considered unspecified. Generic searches can only be specified for the 
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keys specified in the From segment key variable. If they are specified for the To 
segment key variable, it is not a valid search request. The list of identified 
segments is placed in the receiver variable. The list of segments contains only 
authorized key values for that user. 


Attention: Security checking is based on the current user. Utilization of this API 
by a server job that is not running under the user’s authority, defaults to using the 
server job’s user profile. Avoid this by switching to the true user’s profile before 
calling this API. 


Alternately, call Program QRLRRASL instead of using OrlsRetrieveAnyStoreList. 
IBM provided OQRLRRASL for compatibility with previous AnyStore releases. 


Authorities and Locks 


Library Authority 
*EXECUTE 


File Authority 
*CHANGE 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) Contains the key of the segments found. The receiver 
variable format field specifies the format of this variable. 


Length of receiver variable 
INPUT; BINARY(4) Length of the receiver variable. It should be large enough 
to hold the maximum number of segments plus the length of the non-repeating 
part of the format. For the format SEGF0100, the non-repeating part is 36 
bytes. 


Receiver variable format 
INPUT; CHAR(8) Format of the receiver variable. 


SEGFO0100 
RetrieveSegmentKeyList format 


See |“Format of RetrieveSegmentKeyList” on page 177|for a description of these 
formats. 


From segment key 
INPUT; CHAR(*) Starting keys or only keys with which to search. Segment key 
format field specifies format. 


To segment key 
INPUT; CHAR(*) Upper limit (high value) for range search. Segment key 
format field specifies format. 


Segment key format 
INPUT; CHAR(8) Format of the segment key. 


KEYA0100 
Key format 


See |“Format of Segment Keys” on page 177| for a description of these formats. 


Maximum segments to retrieve 
INPUT; BINARY(4) Specifies the maximum segments to place in the segment 
list. The number must be from 1 to 9999. 
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Continuation handle 
INPUT; CHAR(16) This field must either contain blanks or a valid continuation 
handle. If it is blanks, a new search is done with the provided key values. If it 
is a valid continuation handle from a previous call, then the search is 
continued from where it left off. 


Omissible Parameter Group 


Request index status 
INPUT; CHAR(10) Request information on the status of the indexes for a 
specific report. Specify a report name, or no index status returns. If a date 
range is not specified in the From and To segment key formats, then 
requesting index status will most likely not provide any meaningful 
information. Having no date range results in a check for any archived index 
for this report since the installation of OnDemand. Try to limit the searched 
data to a specific date range. Then the Request index status will indicate if 
any archived indexes within that range. This will give you a better indication 
as to whether your search is complete. The default value for this parameter is 
*NO. Valid values for this field are: 


*YES Return index status in index status field. 
*NO _ Do not return index status. 


Index status 
OUTPUT; CHAR(1) Indicates where the indexes are for the specified report 
and date combination. Values for this parameter are: 


0 All indexes within the specified date range are on disk. 
1 At least one index is archived to optical or tape. 
Error code 


I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 169 


Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3C21 
Format name &]1; is not valid. 


CPF3CF1 
Error parameter is not valid. 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3. 


RDR2153 
Unable to obtain proper license. 


RDR2205 
Authority error. 


RDR2301 
Search requested not valid. 


RDR2302 
Date is not valid. 


RDR2303 
Maximum segments that are requested is not valid. 
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RDR2304 


Retrieve list error. 


Format of Segment Keys 
KEYA0100 Format: This format defines the starting and ending search key values. 


Offset 
Dec | Hex | Type Field 
0 0 | CHAR(10) Report Name/Group Name 
10 | A |CHAR() Version 
12 | C | CHAR(25) Key 1 
37 | 25 | CHAR(20) Key 2 
57 | 39 | CHAR(20) Key 3 
77 | 4D | CHAR(20) Key 4 
97 | 61 | CHAR(15) Key 5 
112 | 70 | CHAR(8) Date YYYYMMDD 


KEYA0100 field descriptions. 


At least one of the fields Key 1 thru Key 5 must be specified or message RDR2301 
will be issued. 


Date 


Key 1 


Key 2 


Key 3 


Key 4 


Key 5 


Date to search for in the format of YYYYMMDD or blanks. When blank 
field will not be used as part of the search criteria. 


Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 


Value to search for or blanks. When blank field will not be used as part of 
the search criteria 


Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 


Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 


Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 


Report/Group name 


Report or group name to use. When a report name is provided then only 
the keys for that report are searched. When a group name is used then the 
keys for all reports in the group are searched. A group abbreviation can be 
provided also by using the special form *GRPABVnnn where nnn is the 
three letter group abbreviation. No checking is done for this value. If this 
field is specified in both the segment and to segment key variables then it 
must be the same value in each. The use of ’ for generic search is not 
allowed for this field. 


Version 


Report version 01 - 99 or blanks. When blank field will not be used as part 
of the search criteria. 


Format of RetrieveSegmentKeyList 
The key list can repeat up to 9999 times as required. 
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SEGF0100 Format: This format defines the returned segment information. 


Offset 
Dec | Hex | Type Field 
BINARY(4) Bytes returned 
4 4 |BINARY(4) Bytes available 
CHAR(16) Continuation handle 
24 | 18 | BINARY(4) Offset to segment information list 
28 | 1C | BINARY(4) Number of segment list entries 
32 | 20 | BINARY(A4) Length of segment list entry 


Note: Below is the format of the entries in the segment list. The following 
fields are repeated for each segment list entry. The decimal and 
hexadecimal offsets depend on the number of segment list entries. The first 
segment list entry is found by using the Offset to segment information 


list. 
- - |CHAR(10) Report Name 
- - |CHAR(2) Version 
- - |PACKED(11 0) Compressed length 
- - |PACKED(11 0) Full length 
- - |PACKED(11 0) Displacement 
- - |CHAR(25) Key 1 
- - |CHAR(20) Key 2 
- - |CHAR(20) Key 3 
- - |CHAR(20) Key 4 
- - |CHAR(15) Key 5 
- - |CHAR(8) Date 
- - |CHAR(1) Period 
- - |CHAR(3) Sequence number 
- - |CHAR(1) Reserved 
- - |CHAR(16) Segment handle 


SEGFO0100 field descriptions 


Bytes available 
The length of the RetrieveReportKeylist in bytes. 


Bytes returned 
The length of data returned in the RetrieveReportKeylist in bytes. 


Compressed length 
Size of the segment after it is compressed. 


Continuation handle 
This field is blank if the segment list entries contain all the keys that match 
the specified search. If more entries are available then it contains a handle 
that can be used to continue the search at the point it left off. 


Date Date of the segment in the format of YYYYMMDD. 
Displacement 


Offset from the beginning of the object to this segment. 


178 IBM Content Manager OnDemand for iSeries: Administration Guide 


Full length 
This field contains either the uncompressed length of the segment or the 
AFPDS resource group id (negative number). 


Key 1 Value of key1. 
Key 2 Value of key2. 
Key 3 Value of key3. 
Key 4 Value of key4. 
Key 5 Value of key5. 


Length of segment list entry 
The length of each segment list entry. 


Number of segment list entries 
The number of entries returned in the list. 


Offset to segment list information 
Offset in bytes from the beginning of the format to the segment list entries. 


Period Always contains a period. 


Report name 
Name of report. 


Reserved 
This byte is reserved for later use. 


Segment handle 
Access handle for this segment. 


Sequence number 
Sequence number of archived object. 


Version 
Report version. 


Retrieve AnyStore Segment (QrisRetrieveAnyStoreSegment) 


API 


Parameters 


Required Parameter Group: 


1| Receiver variable Output Char(*) 
2| Length of data returned Output Binary(4) 
3 | Segment index Input Char‘(*) 
4| Segment index format Input Char(8) 
5 | Retrieve information Input Char(*) 
6 | Retrieve information Input Char(8) 
format 
7 | Error code 1/O Char‘(*) 


Service program: QRLSAS2 


Threadsafe: No. 
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The Retrieve AnyStore Segment (OrlsRetrieveAnyStoreSegment) API retrieves 
the specified segment and places it either in the receiver variable or where the 
retrieve information specifies. 


Attention: This API must run using the SAME USER PROFILE that ran the 
Retrieve AnyStore List (QrlsRetrieveAnyStoreList) API, or the segment access 
handle will not be valid. 


Alternately, call Program QRLRRASS instead of using 
OrlsRetrieveAnyStoreSegment. IBM provided QRLRRASS for compatibility with 
previous AnyStore releases. 


Authorities and Locks 


Library Authority 
*EXECUTE 


File Authority 
*CHANGE 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) The field to contain the output. 


Length of data returned 
OUTPUT; BINARY(4) Length of data that is placed in receiver variable. 


Segment index 
INPUT; CHAR(*) Contains index of segment to retrieve. The Segment index 
format field specifies the format. 


Segment index format 
INPUT; CHAR(8) Format of the segment index variable. Do not change any of 
the variables that are provided from the Retrieve AnyStore List 
(OrlsRetrieveAnyStoreList) API segments. Changing the report name, 
compressed length, displacement, data, or sequence number will result in 
unpredictable results. If the segment access handle is not correct, message 
RDR2407 is issued. 


SEGD0100 
Segment index format 


See [Retrieve Segments Format” on page 182/for a description of this format. 


Retrieve information 
INPUT; CHAR(*) The character field that contains required retrieve 
information. The format of the field is determined by the retrieve information 
format field. 


Retrieve information format 
INPUT; CHAR(8) Format of the retrieve information field. See 
ipiceaiore ean a eens 
following values are valid: 


RTVS0100 
Retrieve into a buffer 


RTVS0200 
Retrieve into an IFS file 
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RTVS0300 
Retrieve into a physical file 


RTVS0400 
Retrieve into a spooled file 


Error code 
I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 169 


Considerations for Using the QrisRetrieveAnyStoreSegment API 
Specifying the retrieve information format RTVS0400 creates a spooled file. This 
spooled file spools under one of two jobs. The spooled file becomes part of a user’s 
job and remains owned by that user when either of the following conditions exist. 


* If the current user also owned the original spooled file. 
* Specifying the special value *CURRENT for the spooled file owning profile. 
If this is not the case, then the new spooled file is part of a special system job 


(QPRTJOB) that is created for each user. In this case, the user would be the owner 
of the original spooled file. 


Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3C21 
Format name &1; is not valid. 


CPF3CF1 
Error parameter is not valid. 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3. 


RDR2153 
Unable to obtain proper license. 


RDR2401 
Retrieve read error. 


RDR2403 
File error. 


RDR2404 
File exists error. Reason code &1. 


RDR2406 
Segment open error. 


RDR2407 
Insufficient authority. 


RDR2408 
Report data type mismatch. 


RDR2409 
Recalled from tape. 


RDR2411 
Retrieve buffer length not valid. 


RDR2412 
Retrieve length error. 
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RDR2413 


Create options not valid. 


RDR2414 


Retrieve segment error. Reason code &1. 


RDR2415 


Retrieve file error. 


Retrieve Segments Format 
SEGD0100 Format: This format defines the input segment information. 


Offset 
Dec | Hex | Type Field 
0 0 CHAR(10) Report name 
10 |A CHAR(2) Version 
12) |G PACKED(11 0) Compressed Length 
18 |12 |PACKED(11 0) Full Length 
24 |18 |PACKED(11 0) Displacement 
30 |1E | CHAR(25) Key 1 
55 137 | CHAR(20) Key 2 
75 |4B | CHAR(20) Key 3 
95 |5F | CHAR(20) Key 4 
115 |73 | CHAR(15) Key 5 
130 |82 | CHAR(8) Date YYYYMMDD 
138 |8A_ | CHAR(1) Period 
139 |8B | CHAR() Sequence number 
142 |8E | CHAR(1) Reserved 
143 |8F | CHAR(16) Segment handle 


SEGD0100 field descriptions 


Compressed length 


Size of the segment after it is compressed. 


Continuation handle 


Date 


This field is blank if the segment list entries contain all the keys that match 
the specified search. If more entries are available then it contains a handle 
that can be used to continue the search at the point it left off. 


Date of the segment in the format of YYYYMMDD. 


Displacement 


Offset from the beginning of the object to this segment. 


Full length 


Key 1 
Key 2 
Key 3 
Key 4 


This field contains either the uncompressed length of the segment or the 
AFPDS resource group id (negative number). 


Value of key1. 
Value of key2. 
Value of key3. 
Value of key4. 
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Key 5 Value of key5. 


Length of segment list entry 
The length of each segment list entry. 


Number of segment list entries 
The number of entries returned in the list. 


Offset to segment list information 
Offset in bytes from the beginning of the format to the segment list entries. 


Period Always contains a period. 


Report name 
Name of report. 


Reserved 
This byte is reserved for later use. 


Segment handle 
Access handle for this segment. 


Sequence number 
Sequence number of archived object. 


Version 
Report version. 


Retrieve Information Formats 
RTVS0100 Format: Defines format to retrieve segment into a buffer. 


Offset 
Dec | Hex | Type Field 
0 0 | BINARY(4) Length of receiver variable 


RTVS0100 field descriptions 

Length of receiver variable. Contains length of receiver variable. Maximum length 
is 16 million bytes. The required length for this field for a specific segment is the 
full length from the SEGFO100 format. 


RTVS0200 Format: Defines format to retrieve segment into an IFS file. 


Offset 
Dec | Hex | Type Field 
0 0 BINARY(4) Offset to Path 
4 4 BINARY(4) Path length 
8 8 CHAR(4) Create options 
‘3 ci CHAR(*) Path 


RTVS0200 field descriptions 


Create options 
Whether or not to create the file. The characters and their meanings are: 


Position 1 of this field: Action to take if file already exists. Note: Positions 
2 through 4 are not used. Valid values are: 


0 — Do not create the file. Return error 
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1 — Open the file if it exists, or create it if is does not. Retrieved data 
will be added to the end of the file. 


2 — Open the file if it exists, or create it if is does not. Retrieved data 
will replace the existing data. 


Offset to path 
Offset from the beginning of this structure to the path name. For example, 
a path name that starts in position 12 of this structure would require this 
field to be set to 12 (not 13). 


Path The path to the file, including the file name. The path name can be up to 
64K characters. If storing OfficeVision documents, for example, this path 
might be set to /QDLS/MYFLR/MYDOC. 


Path Length 
The total length of the string that makes up the path specified in the Path 
parameter. This value must be the exact length of the path (including the 
file name) and must not allow for any blanks at the end of the path name. 


RTVS0300 Format: Defines format to retrieve segment into a file. 


Offset 
Dec | Hex | Type Field 
0 0 | CHAR(20) File 
20 | 14 | CHAR(10) Member 
30 | 1E | CHAR(A4) Create options 


RTVS0300 field descriptions 


Create options 
Whether or not to create the file or member. Note: Positions 3 and 4 are 
not used. The characters and their meanings are: 
Position 1 of this field: Action to take if file already exists. Valid values are: 
0 Do not create the file. Return error. 
1 Open the file if is exists, or create it if is does not. 


Position 2 of this field: Action to take if member already exists. Valid 
values are: 


0 Do not create the member. Return error. 
1 Open the member and add the records. 
2 Open the member and replace the records. 
File | The name of the file in which to place the returned segment. The first 10 


characters contain the file name, and the second 10 characters contain the 
library name. You can use these special values for the library name: 


* *CURLIB The job’s current library 
* *LIBL The library list 
Member 


Name of the member to use. You can use these special values for the 
member name: 


* *FIRST — The first member in the specified file is used. 
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RTVS0400 Format: Defines format to retrieve segment into a spooled file. 


Offset 
Dec | Hex | Type Field 
0 0 |CHAR(10) Spooled file owning profile 
20 | 14 | CHAR(20) Output queue 


RTVS0400 field descriptions 


Output queue 
The name of the output queue to use when printing this segment. The first 
10 characters contain the output queue name, and the second 10 characters 
contain the library name. If no output queue is specified then the spooled 
file is placed in the output queue that it was originally in. You can use 


these special values for the library name: 
* *CURLIB The job’s current library 
* *LIBL The library list 


Spooled file owning profile 
The name of the user profile to own the newly created spooled file. If no 

user profile is specified then the owner of the new spooled file is the user 
profile that originally owned the spool file. The user profile must already 
exist. You can use these special values for the user profile: 


* *CURRENT The profile of the current user is used 


Store AnyStore Segment (QrisStoreAnyStoreSegment) API 


Parameters 


Required Parameter Group: 


1| AnyStore handle Input Char(16) 
2 | Store information Input Char(*) 
3| Length of store Input Binary(4) 
information 
4 | Store information format Input Char(8) 
5 | Keys Input Char(*) 
6| Keys format Input Char(8) 
7 | Error code 1/O Char(*) 


Service program: QRLSAS1 


Threadsafe: No. 


The Store AnyStore Segment (QrlsStoreAnyStoreSegment) API stores a segment 
into OnDemand along with its associated key information. The segment can be 
from spool, a data base file member, a buffer, or an Integrated File System file. 


Alternately, call the Program QRLRSASS instead of using 


QrlsStoreAnyStoreSegment. IBM provided QRLRSASS for compatibility with 
previous AnyStore releases. 
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Authorities and Locks 


Library Authority 
*CHANGE 


File Authority 
*CHANGE 


Required Parameter Group 


AnyStore handle 
INPUT; CHAR(16) The AnyStore handle returned when the file was opened 
with the Open AnyStore Object (QrlsOpenAnyStoreObject) API. 


Store information 
INPUT; CHAR(*) Contains the store information. The store information format 
field specifies the format of this field. 

Length of store information 
INPUT; BINARY(4) Length of the store parameter can be up to 16 million 
characters in length. 


Store information format 


INPUT; CHAR(8) The character field that contains required structure that 
matches the store type. See [Store Information Formats” on page 187|for a 
description of these formats. The following values are valid: 


STGIO0100 
Store from a buffer 


STGI0200 
Store from an IFS file 


STGI0300 
Store from a physical file 


STGI0400 
Store from a spooled file 
Keys 
INPUT; CHAR(*) Contains the segment keys. The keys format field specifies 
the format of this field. 


Keys format 
INPUT; CHAR(10) Name of the keys format. See for a 
description of these formats. The following values are valid: 


KEYS0100 
Segment keys 


Error code 
I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 169 


Key Formats 
KEYS0100 Format: Defines format of segment key. 


Offset 
Dec | Hex | Type Field 
0 0 | CHAR(25) Key 1 
25 | 19 | CHAR(20) Key 2 
45 | 2D | CHAR(20) Key 3 
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Offset 
Dec | Hex | Type Field 
65 | 41 | CHAR(20) Key 4 
85 | 55 | CHAR(15) Key 5 


KEYS0100 field descriptions 
Key 1. Value of key1 
Key 2. Value of key2 
Key 3. Value of key3 
Key 4. Value of key4 


Key 5. Value of key5 


Store Information Formats 
STGI0100 Format: Defines format for store from a buffer. 


Offset 
Dec | Hex | Type Field 
0 0 | CHAR(*) Buffer 


STGI0100 field descriptions 


Buffer The character field that contains the segment to store. This can be up to 16 
million characters. 


STGI0200 Format: Defines format for store from an IFS file. 


Offset 
Dec | Hex | Type Field 
0 0 | CHAR(*) Path 


STGI0200 field descriptions 

Path The path to the file, including the file name. It can be up to 64K characters. 
Path Length The total length of the string that makes up the path specified in the 
Path parameter. This value must be the exact length of the path (including the file 


name) and must not allow for any blanks at the end of the path name. 


STGI0300 Format: Defines format for store from a physical file. 


Offset 
Dec | Hex | Type Field 
0 0 | CHAR(20) File 
20 | 14 | CHAR(10) Member 
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STGI0300 field descriptions 


File | The name of the file which contains the segment to store. The first 10 
characters contain the file name, and the second 10 characters contain the 
library name. You can use this special value for the library name: 


* *CURLIB The job’s current library 
* *LIBL The library list 
Member 


Name of the member to use. You can use these special values for the 
member name: 


*FIRST The first member in the specified file is used. 


STGI0400 Format: Defines format for store from a spooled file. 


Offset 
Dec | Hex | Type Field 
0 0 | CHAR(26) Qualified job name 
26 | 1A | CHAR(10) Spooled file name 
36 | 24 | BINARY(4) Spooled file number 


STGI0400 field descriptions 


Qualified job name 
The job that created the spooled file. The qualified job name has three 
parts: 


* Job name CHAR(10). A specific job name, or a special value. * Only the 
job that this program is running. The rest of the job name parameter 
must be blank. 

* user name CHAR(10) — A specific user profile name, or blanks when 
the job name is *. 

* Job number CHAR(6). A specific job number, or blanks when the job 
name is *. 

Spooled file name 
The name of the spooled file to store. 


Spooled file number 
The unique number of the spooled file. The valid range is 1 through 9999. 
The following special values are supported for this parameter: 
* 0 Only one spooled file from the job has the specified file name, so the 
number of the spooled file is not necessary. 
* -1 This uses the highest-numbered spooled file with the specified file 
name. 


Considerations for Using the QrisStoreAnyStoreSegment API 

* When storing IPS files, only the contents of the IFS file store. If the file has 
extended attributes (EAs), these do not store or save when using this API. 

* If an error occurs when storing an AnyStore segment, close the AnyStore object 
before exiting your program. If the AnyStore object is not closed, it may be left 
in a damaged state. If an AnyStore object is closed, but no segments have been 
successfully stored, the AnyStore object will be deleted automatically. 
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Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3C21 
Format name &1; is not valid. 


CPF3CF1 
Error parameter is not valid. 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3. 


RDR2501 
No spooled file found. 


RDR2502 
File open error. 


RDR2505 
Segment to large. 


RDR2506 
Data type mismatch. 


RDR2508 
Store parameter length error. 


RDR2509 
No job found. 


RDR2511 
Spooled file processing error. 


RDR2512 
AnyStore handle not valid. 


RDR2513 
Store error. 


RDR2514 
Store failure. 


RDR2515 
Store SQL error. 


| Archiving User-Defined Data Types for Retrieval by the OnDemand 


Client 


Using AnyStore, it is possible to archive nearly any PC file stored in an Integrated 
File System (IFS) directory on the iSeries. Once a file has been archived, it can be 
retrieved using the OnDemand Client. If the object type of the archived file is 
specified to OnDemand as User Defined, the OnDemand Client will automatically 
launch an application that is associated with the file extension of the file. Using 
this approach, files such as word processing documents, spreadsheets or 
presentations could be archived in OnDemand and then retrieved and viewed 
using the Client. When the PC file is retrieved by the OnDemand Client, the 
appropriate PC application will be launched to display the PC file. 


In order to archive and retrieve User Defined data, a report definition must be 
created with a report type of ANYS, a data type of *IFS and an object type of 255 
(User Defined). In addition, a record must be added to the QARLRAPP file as 
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shown below which defines the file extension for the IFS file. The PC file extension 
is sent to the OnDemand Client when the file is retrieved and it is the extension 
which determines which PC application will be launched to display the file. 


Setting The PC File Extension to Launch a PC Application 


Here are the instructions to set your own extension values. 


1. Create a source physical file by issuing CRTSRCPF FILE(QGPL/APPSRC). 
Note: This file must be in library QGPL. 


2. Add a member to this file using the name of the report definition as the 
member name. You can use SEU to add the member and edit it. The type of 
member does not matter, but it is best to describe it as TXT so that no syntax 
checking will be done. The contents of this member will be described later. 

3. Edit the member and specify the file extension you want to set. See the sample 
below for what can be specified in this member. 

4. Run the QRLGBLDA program specifying the report definition name (all upper 
case characters) as the first parameter and the version number of the report 
definition as the second parameter. Because the version number is numeric, you 
must enclose the value in apostrophes. Running this program will add a record 
to the QARLRAPP file to define the file extension to OnDemand. 


For example, to set the file extension for version 01 of the WORDDOCS report 
definition, you would create a member called WORDDOCS in the APPSRC file in 
library QGPL. After editing it with the data you want, you would then call the 
QRLGBLDA program as follows: 


CALL QRDARS/QRLGBLDA PARM(WORDDOCS '01') 


The contents of the member in the APPSRC file in library QGPL could look like 
this: 


[@_FIXED_@] 

* An * in column 1 makes the record a comment record LRECL=133 

RECFM=F 

CC=ANSI 

CDPG=37 

EXTENSION=DOC 
Each parameter must be on a separate line as shown. The lines must not be 
changed, with the exception of the code page (CDPG) value if your iSeries code 
page is not 37 (US English). 
The [@_FIXED_@] must be entered exactly as shown. On many PCs, you may have 
to change the keyboard mapping for the terminal emulator to get the square 
brackets (even though square brackets are shown on the keyboard itself). If the 


square brackets don’t show on the screen then they are probably not the right 
character. 
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Using the AnyStore APIs to Archive User-Defined Data 


o Launch a PC Application” on page 190/to define the file extension to 
OnDemand. 


To archive the PC files into OnDemand, use the AnyStore APIs described in this 
chapter. Then simply follow the steps described in|Setting The PC File Extension 
fo Launch a PC Application” on page 190 


Hints and Tips for AnyStore 


This section includes information on AnyStore hints and tips for implementation. 


* IBM highly recommends that your AnyStore programs that call the Store API be 
written so that you perform one open of a specific AnyStore report name. 
Perform multiple stores for that report name, then one close of the report name. 
This saves time (performing multiple opens takes considerably more time than 
performing just one). It also saves space (creating one physical object with 
separately retrievable pieces rather than creating multiple physical objects). 
Finally, it saves I/O (when OnDemand migrates the data to optical or tape). 
Even when using the recommended approach, each individual piece (that is 
known as a segment to OnDemand) is separately retrievable. This is due to the 
method in which OnDemand can locate small pieces within the complete 
physical object. 
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Chapter 5. Using the OnDemand Client/Server Feature 


Note: If you have installed the Server feature, be sure to read and follow the 
instructions in the License Management Notice documentation. The 
documentation is attached to your software order packing list. These 
instructions describe how to set the number of licensed users for the Server 
feature. 


Configuring the OnDemand Server 


Review System Values 


There are two OS/400 system values you should check before using the 
OnDemand client/server software. 


* The Client will time out (and end-users will have to log back on) based on the 
QINACTITV system value. Before changing this value, you should check to see 
how the change might affect other users. 


* Ensure that the system value QUTCOFFSET matches the correct value for your 
time zone. For the Eastern Standard Time zone in the U.S., for example, set this 
value to -5:00. (You should end your OnDemand server jobs, change this system 
value, then start your server jobs again. Failure to end the server jobs before 
setting this value could cause clients to store and display incorrect times.) 


Note: If observing daylight savings time (DST or summer time), adjust this 
system value each time DST starts or ends. Otherwise, the time stamps on 
annotations will be off by one hour. The setting for Eastern Daylight Time, 
for example, would be -04:00. 


These settings are necessary to show the correct time for annotations (notes) on 
the workstation. The date/time stamp that is associated with a note is 
communicated based on the Universal Time. The server must know what the 
offset is for the time zone it is in; otherwise, the potential exists for an incorrect 
time to display. In addition, each workstation must know the time zone in which 
it is located. For Windows 95, you specify this in the Time Zone tab of the 
DATE/TIME applet in the Windows control panel. For OS/2, you specify this in 
the General tab of the TCP/IP Configuration Program (TCPCFG.EXE) that is 
normally located in the \tcpip\bin directory. This ensures that the date and time 
that are shown for a note will be the local date and time for that workstation. 
For example, adding a note at 10 a.m. Eastern Standard Time would indicate 8 
a.m. for a co-worker that reads it in the Mountain Standard Time zone. 


Controlling the Run Priority of the Server Jobs 


The run priority of the server jobs (QRLGMGR and QRLGSVR) is by default set 
by the *ANY routing entry in subsystem QSYSWRK. Normally this defaults to 50 
(it depends on the class that is specified for the *ANY routing entry in subsystem 
QSYSWRK). If you wish to change this, you need to add a routing entry to the 
QSYSWRK subsystem description as follows: 


ADDRTGE SBSD(QSYS/QSYSWRK) SEQNBR(nnnn) CMPVAL('QRLGSVR') + 
PGM(QSYS/QCMD) CLS(class) 
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Where nnnn is an unused routing sequence number in the QSYSWRK subsystem 
and class is the name of a class that contains the attributes you want to use. The 
system ships with the following classes that you might consider using: 


QSYS/QSYSCLS25 Run priority of 25 
QSYS/QSYSCLS35 Run priority of 35 


If you want to specify a different run priority, for example 45, then you need to 
create your own class. An example command that does this is: 
CRTCLS CLS(QGPL/ONDSVR45) RUNPTY(45) TIMESLICE(2000) + 
PURGE(*YES) DFTWAIT(30) CPUTIME(*NOMAX) + 
MAXTMPSTG(*NOMAX) + 
TEXT('OnDemand Server class to run at priority 45') 


After creating the class, specify it as the class name in the routing entry for 
ORLGSVR in subsystem QSYSWRK. 


Changing the Port the Server Job Uses 


By default the server job listens for client requests on port 1445. Normally this will 
work fine. It is possible that another application is using this port. If this happens, 
you can change the port that the OnDemand Server uses by running the following 
CL command: 

ADDSRVTBLE SERVICE(ONDEMAND) PORT(nnn) PROTOCOL(TCP) 


TEXT('OnDemand Server') 
where nnn is an unused port on the system. 


Note: The name of the service is case sensitive so be sure it is all uppercase. 
You can see the ports already assigned by issuing the WRKSRVTBLE command. If 


you change the port the server uses, you must also change the Client to use the 
same port. 


Changing the Number of Prestarted Server Jobs 


When you start the server jobs (see |“Starting the Server Jobs”), the default is for 


OnDemand to prestart three jobs. To prestart a different number of jobs, create a 
data area and set the value to the number of prestarted server jobs you require. 
Use the CRTDTAARA command. Name the data area QRLGSVRNO and create it 
in library QUSRRDARS. The type of the data area should be *DEC, with a Length 
of 2 and with 0 Decimal positions. Set the data area’s initial value to the number of 
prestarted jobs you require. 
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Start the server jobs by issuing the following command: STRTCPSVR 
SERVER(*ONDMD). If you have iSeries Access installed on your workstation, you 
can also start the server jobs by using iSeries Navigator. Start at Network, then go 
to Servers, then go to TCP/IP. Right-click on the OnDemand server and request to 
start it. 


This call starts a manager job and three server jobs that run in subsystem 
QSYSWRK. This places the three server jobs in a wait state. The jobs then wait for 
a client to log on. On receiving a client logon request, the manager starts another 
server job to replace the server that is now working with a client. The manager job 
tries to keep three server jobs ready to receive client logon requests. Starting a 
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server job does take some time and resources. These three extra server jobs that 
have been prestarted make it possible to respond quicker to a client’s log on 
request. 


You can automatically start these server jobs when TCP/IP starts on the system by 
using iSeries Navigator. When running iSeries Navigator start at Network, then go 
to Servers, then go to TCP/IP. Right-click on the OnDemand server and select 
Properties. In the OnDemand Properties window, under the General tab checkmark 
the property Start when TCP/IP starts. 


Ending the Server Jobs 


You can end all OnDemand servers by issuing the following command: 
ENDTCPSVR SERVER(*ONDMD). If you have iSeries Access installed on your 
workstation, you can also end the server jobs by using iSeries Navigator. Start at 
Network, then go to Servers, then go to TCP/IP. Right-click on the OnDemand 
server and request to end it. 


This ends all ready servers, but will not end the server jobs that are already 
servicing clients. When the client logs off, the server for that client will end. 


Host Print Overview 


This section provides instructions to configure and use OnDemand for iSeries Host 
Print from the OnDemand Client. OnDemand Client level 2.2.0.14 or higher is 
required on the workstation. 


Host Print is the printing of a document from the OnDemand Client using the 
printers or facsimile support on the iSeries. The data is not transferred to the client 
but is totally processed by the OnDemand Server running on the host iSeries. The 
printing is done synchronously to the request so when the client finishes the 
request the documents have been placed in the output queue specified. All Host 
Printing is spooled and so it always uses output queues on the iSeries. The spooled 
output is owned by you (so you may find it using WRKSPLF) and always has the 
spooled file user data set to QRLRPSEG. 


If you specify a printer file in the report definition and the printer file has a form 
type specified, OnDemand will spool the reprint with the form type from the 
printer file. The printer file is specified on the Retrieval tab of the report definition 
when using iSeries Navigator, or in the Environment section of the report 
definition when using ‘green screen. 


The Host Print function will be active and available to all OnDemand Client users 
unless you take action to disable it. 


Configuring host print 


The host printer names shown in the Print window when Server Printer is selected 
are based on the contents of file QARLRPRT in library QUSRRDARS. When Host 


Print_support is installed, six entries are automatically added to the QARLRPRT 
file.|Table 3 on page 196|describes these entries and their meanings. 
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Table 3. Host printer names 


Printer 


Description 


*ONDEMAND 


This is the default printer for all users. This 
causes the server to use the OnDemand 
Profile data area to determine which iSeries 
output queue is used for the output. You 
may change the output queue at any time 
by using option 31 on the RDARSRPT menu 
on the iSeries. If both the Printer name and 
Output Queue name are specified in the 
Profile, the Output Queue name is used. If 
only the Printer name is specified, the 
Output Queue name in the library list with 
the same name as the Printer name is used. 
An error is returned if neither is specified. 


*USRPRF 


Use the output queue specified in your user 
profile. 


*JOB 


Use the output queue of the OnDemand 
Server job. 


*SYSVAL 


Use the output queue of the same name as 
the device specified in the system value 
QPRTDEV. 


*FAX(*NORMAL) 


*FAX(*FINE) 


Send this as a Fax in *NORMAL mode. 
When normal mode is used the resolution of 
the fax is 203 dots per inch in the horizontal 
direction by 98 dots per inch in the vertical 
direction. Normal mode uses less 
transmission time than fine mode. 


Send this as a Fax in *FINE mode. When 
fine mode is used the resolution of the fax is 
203 dots per inch in the horizontal direction 
by 196 dots per inch in the vertical direction. 
Fine mode produces a better quality fax than 
normal mode. 


You can also add specific output queues to this file using DFU or another data 
entry program. Entries that you add this way are shown in the Print window on 
the client in the form of QUEUELIB/QUEUE. |Table 4|describes the fields in this 


file: 

Table 4. Output queues 

Field Description 

PID This is an internal printer ID number. This 


must be unique within the file and can be 
any positive number that is not already 
used. 
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Table 4. Output queues (continued) 


Field 


Description 


NAME 


This is the name of an authorization list (in 
uppercase) that specifies who can see this 
printer in the list of printers on the server. If 
this field is blank or the first character in 
this field is an asterisk (*), this output queue 
will be listed for every user. If the field 
contains anything else, it is assumed to be 
the name of an authorization list that 
controls who can see this entry in the 
pull-down list on the client. 


DESC 


QUEUE 


This is a 50 character description of the 
printer. The client never shows this 
description so you can leave it blank if you 
wish. 


The 10 character name of the output queue 
(in uppercase). If a user is not authorized to 
use this output queue name (as defined by 
the authorization list specified in the name 
field) it will not show up in the list of 
printers on the client for that user. All of the 
valid special values that can be entered for 
this field are automatically added when the 
Host Print support is installed. Unless you 
have deleted these records, you should 
never have to enter any special values for 
this field. 


QUEUELIB 


The 10 character name of the library (in 
uppercase) where the output queue is 
located. You can specify the special values of 
*LIBL or *CURLIB for this field. 


TYPE 


This is a 1 character field that indicates the 
type of printer this is. A value of ’P’ 
indicates this is an Output Queue and ’F’ 
indicates that it is a Fax device. Note that 
these values must be in uppercase. 


The example DFU screen below shows the addition of a new printer to the Host 
Print list. In this example the authorization list ONDPRT will be used to determine 
which users have access to this output queue through Host Print (see|Figure 215 on 


page 195) 
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a > 


WORK WITH DATA IN A FILE. Mode. . . . : ENTRY 
Format. = «3. % PRIREC Fite: oa cs, 2 (QARERPRT 
Printer ID: 7 

Printer Name: ONDPRT 

Printer Desc: OnDemand Network Printer 

Printer Queue: OND4312 

Printer Queue Library: *LIBL 

Printer Type: P 

F3=Exit F5=Refresh F6=Select format 

F9=Insert F10=Entry Fll=Change 


Figure 215. Adding a Host Print File Entry 


Using host print 


When you choose to print a document, the Print window is displayed which 

allows you to select either a Local Printer or a Server Printer (see|Figure 216 on 

page 199). 

Note: the Server Printer will be grayed out if no server printers are available for 
this user. This is determined by the contents of file QARLRPRT in library 


QUSRRDARS and the user’s authority to the specific output queues named 
in this file through the use of authorization lists. 
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by fe 


*ONDEMAND aa 


OF 
f=) Lorrent Page 


P) Selected Pages 


Figure 216. OnDemand Client Print Dialog 


If you choose to Print the document this is the only window you will see. You may 
choose different values for the printer by selecting from the drop down list. 


Note: the list of printers is sorted in alphabetical order in the drop down list so 
you will have to scroll up to find the Fax printers 

The special values shown (such as *ONDEMAND) are described above in the 

Configuring Host Print section. Specify the number of copies you want printed and 

click on the Print button to process the Host Print request. 


If you choose to Fax the document (by choosing either *FAX(*NORMAL) or 


*FAX(*FINE) as the Server Printer), the Send Fax window opens up when you click 
on the Print button (see |Figure 217 on page 200). 
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Send FAX Ed 


— Recipient 
Attention Set Options... | 
Company Cancel | 
Fax Number Help | 
Sender 


Name [John Public 
Company IBM Coporation = 
Tel Number [oss-555-1212— 
Fax Number fC 


CoverPage |*YES 


Subject 


Notes 


Figure 217. Host Print Send Fax Dialog 


The Send Fax window allows you to specify the Fax Number of the Recipient and 
the contents of the Cover Page if you are sending one. If Cover Page is set to *NO, 
only the Fax Number of the Recipient is used. If Cover Page is set to *YES you can 
either enter in the Recipient information or Select... from previously saved 
information. When you enter the Fax Number of the Recipient, the Save button 
will become active so that you can save this information for future use. When you 
click on Save, the Save Recipient Information window opens so you can name this 


recipient (see |Figure 218). 


Save Recipient Information | 3x 
Identifier 


[Public 


coe | te | 


Figure 218. Host Print Save Recipient Dialog 


Type in the Identifier field the name you want to use to identify this recipient in 
the future. This identifier is case sensitive and may contain blanks. If you check the 
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Public box then all users will be able to see this recipient. If it is not checked, then 
only you will see this recipient when you click on Select in the Send Fax window. 
Click on Save to actually save this recipient information for future use. If you 

choose an identifier that already exists, you will be asked if you want to replace it 


(see |Figure 219). 
OnDemand 


2) Recipient information with this name already exists. Do you wish to replace it? 


Figure 219. Host Print Save Recipient Confirmation 


Rather than entering the Recipient information every time in the Send Fax window, 


you may Select... from previously saved Recipient information. When you click on 
Select..., the Select Recipient Information window opens (see |Figure 220). 


Select Recipient Information x] 


Darrell [Private] 
John Sherill [Public] 
Nancy O [Public] : 


: - Delete 
Attention [Nancy O'Brien 


Company IBM 


Fax Number foo0-1 23-1234 


Figure 220. Host Print Select Recipient Dialog 


This window displays a list of previously saved recipients. Click on the one you 
wish to use and then click on Select to close the window and copy the information 
to the Recipient information in the Send Fax window. 


The Sender information in the Send Fax window defaults to the values in your 
OnDemand Profile data area (QUSRRDARS/UserProfileName) at the time you 
sign-on to OnDemand. The Sender information is only used if you specify *YES for 
the Cover Page. If you change any of this information by typing over it in this 
window it changes the values in the OnDemand Profile data area but not the 
default values during this current sign-on. If you wish to immediately update the 
default Sender information or the Cover Page value, you can do that by clicking 
on the Set Options... button. This is described in more detail below. 


Chapter 5. Using the OnDemand Client/Server Feature 201 


The Subject and Notes fields never default to anything so you must enter what 
you want here every time you send a Fax. Both the Subject and Notes fields only 
use the first 40 characters that you enter (due to limitations of the iSeries Fax 


support). 


Click on Send to have the server process this Fax request. The standard 
OnDemand interface to iSeries Fax support (program QRLRSFAX) is used to 
process the Fax request. 


If you click on the Set Options... button in the Send Fax window, the FAX options 
window opens (see |Figure 221). 


FAX Options Ea 


[Initialize information from database 


User Information 


Name ichnQ Public = 
Company [IBM Corporation 
Tel Number [ESS555-121200— 
Fas Number [fo 
Cover Page fvES sis 


cael |e _| 


Figure 221. Host Print Fax Options Dialog 


The Initialize information from database checkbox is currently not supported and 
should not be checked. The User Information is where you can immediately 
update the Sender information that the client uses as the defaults in the Send Fax 
window. It also updates this information in your OnDemand Profile data area. 


There are three lines of sender information that are included on the cover page of 
the fax. Each of these lines may be up to forty characters long and consists of the 
data in the Name field, Company field and Tel Number field respectively. 


The Cover Page value of *YES or *NO is also stored in your OnDemand Profile. 
The Fax Number field is not used on the cover page and is not retained in the 
OnDemand Profile. Click OK to update your OnDemand Profile. 


Disabling host print 
The Host Print function can be disabled by setting the type field in all the records 
in file QUSRRDARS/QARLRPRT to any value other than ’P’ or ’F’. 
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You can selectively disable the six special value printer names in 
QUSRRDARS/QARLRPRT by specifying the name of an authorization list in the 
NAME field of the record with the special value printer name. For instance, you 
can control who will see the *FAX(*NORMAL) choice by creating an authorization 
list called HOSTFAX and entering the value HOSTFAX in the NAME field of the 
record in QUSRRDARS/QARLRPRT with *FAX in the QUEUE field and 
*NORMAL in the QUEUELIB field. You can control which users will see that fax 
capability by giving those users *READ or *USE authority in the authorization list 
and all others “EXCLUDE. You may use *PUBLIC or specific user profiles to do 
this. 


Additional Client/Server Topics 


Review this section for additional information on the OnDemand client/server 
feature. 


* For all reports with a report data type of “OTHER, the data that was previously 
archived by OnDemand - R/DARS is available to the OnDemand Client. 


* To show fully-resolved AFP (Advanced Function Presentation) data, the 
command (STRCDSRDAR) must store the AFP resources with the report. This 
is true for all reports with a report data type of *LINE, *AFPDS, or 
*AFPDSLINE. This is because the OnDemand Client needs to have the AFP 
resources sent to it when you view the document. Having the resources already 
present on the workstation is not sufficient; the server must send them. 
Previously, OnDemand - R/DARS did not save the actual AFP resource objects, 
and therefore there are no resources that are sent. Starting with V4R2 (or with 
PTF SF43278 for V3R2 or SF43212 for V3R7) and after, the STRCDSRDAR 
command stores the AFP resources with the report. For previously stored 
reports, the textual data displays. (You will receive messages on the Client that 
you can ignore for AFP resources that are not sent.) 


* You can define a report of data type *OTHER that has an associated AFP 
overlay so that the data appears in the Client viewer with the overlay applied. 
(Without completing the following setup steps, the data portion displays without 
the overlay applied.) 


To enable this function, you must do the following: 


1. Use iSeries Navigator’s OnDemand Administration interface to check the Use 
archived AFP overlays when viewing or printing locally using the client 
viewer check box on the Retrieval tab. 

2. Specify a printer file (that has the name of the overlays specified in it) in the 
Report Definition. 

3. Store the report by using a spooled file - not a database file that you have 
created by using the CPYSPLF command. (This means that the FILE 
parameter on the STRCDSRDAR command must specify *SPLF, or you 
must use the output queue monitor to store your reports.) 


Note that there are a number of items to consider when enabling this function: 

— When enabled, the OnDemand Client viewer will no longer support logical 
views (columns) for that version of the Report Definition. After you enable 
this function, you cannot use logical views to rearrange or hide columns of 
data for this report. 

— You will only see overlay for reports stored after OnDemand started storing 
the overlay resource. Resources for *OTHER data began to be stored when the 
following PTFs or their supersedes were applied: 


- V3R2 - SF43277 
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- V3R7 - SF43211 
- V4R2 and beyond - in the base code 


These PTFS were made available in September 1997. The specific documents 
that display with their overlay depends on one of the following conditions: 


- When you loaded and applied these PTFs. 
- When you installed V4R2 or later on your system. 


— The Client viewer will show the document without the overlay if any of the 
following items is true: 


- The system stored the report before OnDemand began to store overlay 
resources. (See previous item.) 


- The Report Definition does not have a specified printer file. 
- The Report Definition does not have a specified overlay in the printer file. 


- The system stored the report by using a database file as the input rather 
than a spooled file. 


— This function retrieves and converts the document from line data to AFPDS. 
Although this does not take a lot of time, it does take system resources. Use 
this function only when needed. 


— The name of the overlay specified in the printer file must match the name of 
the overlay specified in the spooled file that was stored. 


— The overlay you see (or print locally) from the Client is the originally stored 
document overlay. 


— This function does not change how things work on the iSeries from the 5250 
screen. The function uses the overlay that is currently defined in the printer 
file of the Report Definition to print the document on the iSeries from the 
5250 screen. 


— If you print the document on a local printer from the Client viewer, it does 
not need to be an AFP printer. 


— To use of the viewer user exit to specify a different viewer, the specified 
viewer must process AFP data streams for this Report Definition. 


For reports within a report group, you can have the Client folder list show the 
report group name and the individual report names within the group. Click on 
the Show report in folder list check box by using iSeries Navigator’s 
OnDemand Administration function. If, instead, you would like the Client folder 
list to show only the report group name, make sure the check box is not checked. 


To change the default date range for a specific report, use iSeries Navigator’s 
OnDemand Administration to specify Default date search range information. 
You can specify the number of days, months, or years for the date range, and 
whether the default applies forward or backward in time. If you do not define a 
default date range in this way, then the Client assumes a 30-day default date 
range. 


For *OTHER report types with overprint (overstrike) characters, you can cause 
the Server to combine the overprinting lines with their previous lines in the 
data. (Overprint lines have a carriage control character of ’+’ in the first position 
of the print data.) Choose the Merge overprinted lines check box by using 
iSeries Navigator’s OnDemand Administration. This enables the Server to take 
any lines with a ‘+’ in column 1 and copy them, character by character, to the 
previous line. (The server copies the character only when the character in the 
previous line is a blank or underscore character.) This preserves the line spacing 
of the original document when viewed or printed by the Client. This will not 
cause text to be bolded or underlined when viewed or printed by the Client. 
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* To enable the e-mail function in the OnDemand Client, you must have 
Messaging for Windows and have a registered MAPI mail product. You can 
either select the Send function from the File option on the menu bar or 
customize the toolbar with the Send icon. You can select to send the segment as 
an attachment or embed it in the body of your e-mail message. Your registered 
MAPI mail product will open a send message window and allow you to address 
and send the e-mail message. 


* Workstation files such as word processing documents or spreadsheets can be 
archived in OnDemand and retrieved using the OnDemand Client. When the 
data is archived in OnDemand as "user-defined” data, the Client will 
automatically launch the appropriate workstation application based on the file 
extension of the retrieved file. This support is enabled by storing the workstation 
file with AnyStore, and then creating the AnyStore report definition with iSeries 
Navigator, specifying report type ANYS, data type IFS, and Object Class 
"user-defined." 


* Generally, information that is retrieved from the server is kept by the Client. 
This information does not update on the Client until you logoff and log back on. 
The two major exceptions to this are the hitlist and the actual documents. They 
update when you do a search or when you view a document from the hitlist. 


A few examples where information is not updated: 


— The list of folders is determined when you log on. By defining a new report 
to OnDemand for iSeries, you will not see it until the next time you log on. 


— The attributes for a folder are determined when you open the folder for the 
first time during a logon session. Even if you close the folder and reopen it, 
the information does not update until you logoff and log back on. This is 
important for you to know when you are using the OnDemand Archive 
plug-in for iSeries Navigator and are trying to verify changes by using the 
Client. The Client will only see changes made by the OnDemand Archive 
plug-in for iSeries Navigator after you logoff and log back on. 


* The OnDemand Client user has no visibility to the location of the data that you 
select for retrieval. If the data resides on optical or tape, retrieval times will 
simply be a bit longer. 

* The OnDemand server never searches indexes that are on optical or tape. This is 
because you do not select a specific report date before you specify the search 
value. Therefore the server does not know which set of index records to retrieve 
before doing the search. For this reason, you do not want to archive your index 
records to optical or tape if your end-users are using the OnDemand Client. 
(Review your OnDemand Report Policy definitions to determine if you are 
archiving index records to optical or tape). 


* Logical view support is not available for reports of data type *AFPDS, 
*AFPDSLINE, or *SCS. 


* OnDemand character-based report overlays are not supported by the Client. 
Typically the character-based overlay lines that are created for nonprogrammable 
terminal users as defined by using Work with Report Overlays on the Report 
Administration Menu. 


* The characters IP in the first two positions of the Workstation ID field identify 
Client activity. The system logs this activity in the OnDemand audit file 
(QARLRAUDIT in library QUSRRDARS). 


Problem Determination 


Use this section to assist in problem analysis for the OnDemand Client or server 
programs. 
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* Any serious errors should cause a joblog to be produced. The joblog is a vital 
part of the information that is needed by your software service provider to 
determine what happened to cause the error. Always save the joblog when you 
have a problem. 


* The message "Connection cannot be established for the server,” indicates one of 
many things that may need attention. 


If this message occurs at logon, then perhaps one of the following conditions 
exists. 


A server job is not active. 


Issue WRKACTJOB JOB(QRLG*) from the OS/400 command line. There 
should be one job that is named QRLGMGR with the normal status of 
DEQW. There should be three or more jobs that are named QRLGSVR in 
either DEQW or SELW status. There should always be at least one job in 
SELW status as it is the job that is waiting for a client to request a logon. 
Once you have logged on a client, its job will also be in one of two states of 
operation: 


- SELW when it is waiting on the client. 
- RUN when it is serving the client. 


If these jobs are not active, you should start the servers by issuing the 
following command: STRTCPSVR *ONDMD. 

Communication line problem 

Issue PING from either the OS/400 command line or the workstation to see if 
you can communicate with the other machine. The format of the command is 
PING n.n.n.n. where n.n.n.n. is the TCP/IP address of the machine you are 
trying to reach (either the client if on the server or the server if on the client). 
TCP/IP is not active on the server 


Issue WRKTCPSTS OPTION(*IFC) from the OS/400 command line. Look at 
the line that has a line description (not *LOOPBACK) to see what the 
interface status is. It should show ACTIVE. If it is INACTIVE, issue a 
STRTCP command on the OS/400 command line. If it shows some other 
status, see the Help text for the interface status field for suggested actions. 
The TCP/IP address for the server is wrong 

Issue WRKTCPSTS OPTION(*IFC) from the OS/400 command line. Look at 
the line that has a line description (not *LOOPBACK) to see what the IP 
address is for the iSeries. Check that it matches the address that is specified 
on the Client. 


If this message occurs after logging on, one of the following conditions exists: 


The server job has ended. 


If the server job has ended, there should be a joblog for it. You can find the 
joblog by issuing WRKSPLF SELECT(QRDARS400) from the OS/400 
command line. Then press F18 to go to the bottom of the list to find the last 
joblog. You should see a spooled file named QPJOBLOG for user 
QRDARS400 with user data of QRLGSVR. If you cannot find it, make sure 
that it has not printed. If it has not printed and it appears on the list, choose 
option 5 to display it. Then look at the messages in the joblog. You should see 
message RDR2701 that shows who signed on to this server job. You can use 
that information to help determine that this is the correct joblog. Look 
through the joblog for other messages that might indicate why the server 
ended. In some cases, you may have to contact your software service provider 
for assistance. 


Communication line error 
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Check to see if there are any errors that are logged for the communication 
line that you are using. Log off the Client and see if you can now log back 
on. Caution: This will also work when the server job ended abnormally, but it 
does not really solve the problem. Always check to see if the server job ended 
before assuming that there was a communication error. 


* A message "User ID or Password is not valid for the server", indicates that any 
of the following could have occurred: 


— The password expired. 


If the password for the user has expired, you cannot log on, and the Client 
displays this message. Go to the iSeries and change your password during the 
sign-on process or work with your security administrator to take care of the 
expired password. If your password has not yet expired, you can change your 
password from the Client by selecting File and then Change Logon 
Password. 
— User ID is not valid 
— Password is incorrect 
— You tried to logon to the wrong server or an incorrect TCP/IP address 
* The message "The server failed while accessing folder data” during logon 
indicates that the user attempting to logon has no authorization for OnDemand 
archive access. Correct this by accessing the OnDemand Report Administration 
Menu on the iSeries. Then add the user by using option 10 to Edit/ Authorize 
OnDemand Users. 
* The message "No folders are available on the server” after a successful logon 
indicates that one of following conditions exists: 


— The user does not have authorization to any report names (folders). 


— The user does have authorization to some report names (folders), but no 
archived (stored) spooled files exist for any of them. 


* In order for your iSeries data to appear with similar fonts in your Client, you 
may need to map the fonts to fonts that display on you workstation. This is 
especially true if you use fonts in your AFP documents other than the ones that 
are listed below. 


— IBM Core Interchange (Latin only) 

— Compatibility. 

— Coordinated. 

— Sonoran. 

— Data fonts. 

For more information about mapping fonts, refer to the OnDemand Client online 
help. 


* To locate the correct server job for a particular user, look at the joblogs for the 
server jobs. Each server places a message in the joblog that identifies the logged 
on user. 
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Chapter 6. Using the OnDemand Media Administration Menu 


You can use the selections in this group of screens to manage your tape and optical 
media. With them, you choose how and where to place your archives and backups, 
establish capacity thresholds and space reuse policies, and work with storage 
groups that let you store data on one or more sets of optical volumes. 


Optical and Tape Media Management 


One of the benefits of using OnDemand for your data archives is that you never 
have to specify a particular optical volume or tape volume when storing or 
retrieving your data. OnDemand manages this for you. You define a policy for 
your reports or objects that have similar storage requirements (how long to keep 
and where). Each policy then refers to a group of optical or tape volumes that can 
be used for that policy. For optical volumes, this group is called a storage group. 
For tape, the grouping is done by media type which is a physical characteristic of 
the tape media itself. 


For instance, when you store a report, the report’s definition is checked to 
determine which policy to use. The report policy in turn is used to find the optical 
storage group and/or tape media family it should use. The actual optical volume 
used within the storage group is the volume that has the smallest amount of space 
available on it and is not yet marked full. This is done so that once OnDemand 
starts to use a volume, it will continue to use that volume until it is full. The actual 
tape volume is chosen from the volumes available of that media type, selecting the 
tape with the smallest number of bytes available on it that is not yet marked full. 


When storing data, the media used by each OnDemand feature is determined as 
follows: 


For Spool File Archive 
The report definition specifies a report policy which points to the optical 
storage group and tape media type to use. 


For Object Archive 
The object control table entry specifies an object policy which points to the 
optical storage group and tape media type to use. 


For Record Archive 
The file creation commands require you to specify the optical storage 
group to use. 


For AnyStore 
The report definition specifies a report policy which points to the optical 
storage group and tape media type for use. 


The OnDemand administrator must ensure that there are optical volumes and tape 
volumes that identifies the available space in the OnDemand inventory tables. 
Accomplish these and other media-related functions using the menu options or 
commands that are described in this chapter. 


Once data has been written to optical or to tape, OnDemand knows where it 


placed the data so you do not have to specify the volumes where the data is 
located. 


© Copyright IBM Corp. 1997, 2002 209 


210 


To Access the Media Administration Menu, you can: 
* Type 4 on the OnDemand for iSeries Main Menu command line,|Figure 222| 
* Or, use the Fast-Path command: 


GO RDARSM 


on the OS/400 command line, for direct access to|Figure 223 on page 211 


ONDEMAND OnDemand for iSeries 
System: | ONDMD400 
Select one of the following: 


Report Administration Menu 
Object Administration Menu 
Record Archive Menu 

Media Administration Menu 


PwWNrFe 


90. Signoff 


Selection or command 
===>4 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=Information Assistant 
F16=System Main Menu 
a Copyright IBM Corp. 1992, 2000. All Rights Reserved. 


Figure 222. OnDemand for iSeries Main Menu 
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a 
RDARSM OnDemand Media Administration Menu 
System: | ONDMD400 
Select one of the following: 


1. Work with Tape Devices 
2. Work with Tape Volumes 


10. Work with Storage Groups 
11. Work with Optical Volumes 


20. Optical Support Menu 
21. Work with Communications Side Information (LAN Attached Optical Only) 


40. OnDemand Main Menu 


51. Reset Optical 
52. Reset Tape 


Selection or command 
===> 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
Fl6=System Main Menu 
(C) Copyright IBM Corp. 1992, 2000. All Rights Reserved. 


Figure 223. OnDemand Media Administration Menu 


Option 1. Work with Tape Devices 


Use this option to add, change, remove, or display a tape device. If you prefer to 
use a graphical user interface for this function, you can use iSeries Navigator 
instead. 


To Add a Tape Device 
‘If you use tape media, you must indicate which tape devices that OnDemand can 
use. When you select this option, the first screen, |Figure 224 on page 212} appears. 


1. If you use BRMS for tape management, you do not need to add anything here; OnDemand uses information in the policy 
definition to link to BRMS. 
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(a 


Bottom 


Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Medilaytypeaenpcae ccm ceo uesarees >*TAPDEV *OPTVOL, *STGGRP, *TAPDEV... 
Tape device. = << sass, ei et ee *ALL Name, generic*, *ALL... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 224. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 225} Work witH Tare Devices. A list of devices and 


their descriptions appears. 


ra 
Work with Tape Devices 
1/24/98 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Opt Device Media Text 
1 TAPO5 
TAPO1 Qic 
TAPO2 QIc Quarter-inch cartridge 
TAPQ6 HIC This device has a cartridge loader 
F3=Exit F5=Refresh  F12=Cancel 


ONDMD400 
9:24:17 


Bottom 


Figure 225. Work with Tape Devices 


Press Enter to continue to|Figure 226 on page 213 
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(— ; es 
Add Tape Device ONDMD400 
1/24/98 9:24:26 


Type choices, press Enter. 


Tape device: ss 3 5! Ge Sk es TAPO5 Name 
Media supported ........ Read Write 
*REEL *REEL 


Automatic cartridge 


loader capacity ....... 0 1-99, O=Not installed 
Median ilitibray ss) o<2 vs tec ee eo tee noe cs Name 
MEX ayo a mom wut ancien mena tee vee Standard Reel Tape Device 
F3=Exit F12=Cancel 
e 


Figure 226. Add Tape Device 


Describe the iSeries tape drive. 


Press Enter to add the tape device information. |Figure 227| appears. 


ie : ~ 
Work with Tape Devices ONDMD400 
1/24/98 9:25:26 


Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Opt Device Media Text 


TAPO1 QIC 
TAPO2 QIC Quarter-inch cartridge 
TAPQ6 HIC This device has a cartridge loader 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 


Tape Device added. 
NE a / 


Figure 227. Work with Tape Devices 


Press F5 to display your addition. 


To return to the ONDEMAND MepiA ADMINISTRATION MENU, |Figure 223 on page 211 
press F3. 


2. If you are using BRMS for tape management, do not add anything to this screen. 
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To Change Tape Device Characteristics 


To change the characteristics of a tape device that is currently in the tape device 
file, select option 2, Work witH Tare Devices from the ONDEMAND MEDIA 


ADMINISTRATION MENu,|Figure 223 on page 211||Figure 228) appears. 


ie 
Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Medita: ty perce sy 2. es eu Stoel cece He) >*TAPDEV *OPTVOL, *STGGRP, *TAPDEV... 
Tape: device: 4 <.% <0. 4 2 a *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 228. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 229 


fe 
Work with Tape Devices ONDMD400 


1/24/98 9:25:30 


Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Opt Device Media Text 


TAPO1 QIc 
2 TAPO2 QIc Quarter-inch cartridge 
TAPO5 REEL Standard Reel Tape Device 
TAP06 HIC This device has a cartridge loader 


Bottom 


F3=Exit F5=Refresh  F12=Cancel 


Figure 229. Work with Tape Devices 
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Press Enter to move to |Figure 230} which shows the characteristics of the tape 
device you want to change. 


(— ; e 
Change Tape Devices ONDMD400 


1/24/98 9:26:03 
Tape device as. =. << @ « -« < ¢ “TAPRO2 


Type choices, press Enter. 


Media::supported: 2 ss: 4. 5 4s: 52. Read Write 
*QIC525 __ *QIC525 __ 
*QIC1000_ *QIC1000_ 
*QIC2GB__ *QIC2GB__ 
Automatic cartridge 
loader capacity ....... 0 1-99, O=Not installed 
Media: Vaibrartey ss <i Ge See ees Name 
TREX SER ae tor cents voter castes ten Quarter-inch cartridge 


F3=Exit  F12=Cancel 


/ 
Figure 230. Change Tape Devices 
You can change the fields by typing new information over what is displayed. 
Press Enter to save your changes. |Figure 231] appears. 
a 
Work with Tape Devices ONDMD400 +) 
1/24/98 9:26:25 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Opt Device Media Text 
TAPO1 QIc 
TAPO2 Qic Quarter-inch cartridge 
TAPO5 REEL Standard Reel Tape Device 
TAPO6 HIC This device has a cartridge loader 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Tape Device changed. oy 


Figure 231. Work with Tape Devices 


To return to the ONDEMAND MepiA ADMINISTRATION MENU, [Figure 223 on page 211 


press F3. 
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To Remove a Tape Device 


To remove a tape device that is currently in your tape device file, select 
Work wITH Tare Devices from the ONDEMAND Mep1a ADMINISTRATION MENU, 


fon page 2i1] Figure 252] appears. 


option 1, 
Figure 223 


i 
Work with Media for OnDemand (WRKMEDRDAR) >) 
Type choices, press Enter. 
Mediatype: a. si ee ee ce eae >*TAPDEV *OPTVOL, *STGGRP, *TAPDEV... 
Tapesdevice: 3 ee eel se *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
7 
Figure 232. Work with Media for OnDemand (WRKMEDRDAR) 
Press Enter to move to|Figure 233 
ce : : ae 
Work with Tape Devices ONDMD400 
1/24/98 9:26:37 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Opt Device Media Text 
TAPO1 QIC 
TAPO5 REEL Standard Reel Tape Device 
TAPQ6 HIC This device has a cartridge loader 
4 TAP99 REEL Test 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 2 


Figure 233. Work with Tape Devices 


Press Enter to continue to|Figure 234 on page 217 
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fe 
Confirm Removal of Tape Device ONDMD400 


1/03/98 12:59:28 
Press Enter to confirm your choice for 4=Remove. 
Press Fl2=Cancel to return to change your choices. 


Tape device . ss < a <= « % = ¢ TAP99 
Media supported .......: Read Write 
*REEL *REEL 


Automatic cartridge 

loader capacity ......: 0 
Mediaritibrary: 3)os2 vs, tec: eo tee ness 
MEX atone ceo ue atcta en arene ees DmOS'G 


F12=Cancel 


Figure 234. Confirm Removal of Tape Device 


OnDemand shows you the tape device you have selected to remove. 


If you entered the wrong data, you can change your entry by pressing F12 to 
return to the previous screen. Type the correct device and press Enter. 


If your entry is correct, press Enter. 


The message in|Figure 235] confirms that the tape device was removed. 


ie 
Work with Tape Devices ONDMD400 


1/03/98 12:59:32 


Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Opt Device Media Text 


TAPO1 QIC 

TAPO5 REEL Standard Reel Tape Device 

TAPQ6 HIC This device has a cartridge loader 
TAP99 REEL Test 


Bottom 
F3=Exit F5=Refresh F12=Cancel 
Tape device removed. 


Figure 235. Work with Tape Devices 
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To return to the ONDEMAND MepiA ADMINISTRATION MENU, |Figure 223 on page 211 


press F3. 


To Display the Tape Devices 


To display a tape device that is currently in your tape device file, select 
Work witH Tare Devices from the ONDEMAND MepiA ADMINISTRATION MENu, 


option 1 
Figure 223 


ia 
Work with Media for OnDemand (WRKMEDRDAR) > 
Type choices, press Enter. 
Mediiatitypessinc.cca <u te pace au teeks >*TAPDEV *OPTVOL, *STGGRP, *TAPDEV... 
Tape device: i... sae ee *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
oy 
Figure 236. Work with Media for OnDemand (WRKMEDRDAR) 
Press Enter to move to|Figure 237 
a 
Work with Tape Devices ONDMD400 *) 
1/24/98 9:26:37 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Opt Device Media Text 
TAPO1 QIC 
5 TAPO2 QIc Quarter-inch cartridge 
TAPO5 REEL Standard Reel Tape Device 
TAPQ6 HIC This device has a cartridge loader 
Bottom 
F3=Exit F5=Refresh  F12=Cancel ) 


Figure 237. Work with Tape Devices 


IBM Content Manager OnDemand for iSeries: Administration Guide 


Press Enter. |Figure 238]}shows you the characteristics of the tape device you 


selected. 
( : ; e 
Display Tape Device ONDMD400 
1/24/98 9:26:31 
Tape device «3.5. <= «= 2 TAPO2 
Media supported. ......: Read Write 


*QIC525 *QIC525 
*QIC1000 *QIC1000 
*QIC2GB *QIC2GB 


Automatic cartridge 


loader: capacity «3 «= % = ¢ 0 
Mediivan wibieainycsc essen tse ce sso as cs 
TOXt. oe ee a ws ee se SF “Quarter=inchicartridge 
TMUS@ filigge ost ce essen se ees ste es 


Bottom 
Press Enter to continue. 


F3=Exit  F12=Cancel 


Figure 238. Display Tape Device 


Notice this field: 


Inuse flag 
If there is a value in this field when you display the tape device, it 
indicates that the device is in use. 


If a tape backup, a tape archive, or a tape object recall is not running, a 
value in this field usually indicates a tape error. 


To clear the flag, access the ONDEMAND MepIA ADMINISTRATION Menu and 
select|“Option 52. Reset Tape” on page 247 
To return to the ONDEMAND MepiA ADMINISTRATION MENU, |Figure 223 on page 211 


press F3. 


Option 2. Work with Tape Volumes 


Use this option to add, change, remove, or display a tape volume. If you prefer to 
use a graphical user interface for this function, you can use iSeries Navigator 
instead.? 


When you select this option, |Figure 239 on page 220] appears. 


3. If you use BRMS for tape management, you do not need to add any data to this table. OnDemand uses the Policy definition to 
link to BRMS directly. 
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Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Medifast peseanetac msm cece nase >*TAPVOL *OPTVOL, *STGGRP, *TAPDEV... 
Taper Volumes 228 seas, en cet ee oe *ALL Identifier, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 239. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 240 on page 221! A list of volumes and their 


descriptions appears. 


To Add a Tape Volume 


You must add each tape volume that you want OnDemand to use. 


Enter a volume ID for each initialized tape you want to use for report archives or 
backups. 


Initialize each tape before you define it to OnDemand. 
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ie = 
Work with Tape Volumes ONDMD400 
1/24/98 9:35:47 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Option Volume Media Capacity 
1 ROOOO1 
TA HIC 330000000 
TAPE QIC 1200000000 
T01010 = QICc 525000000 
012043 REEL 160000000 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 
7 
Figure 240. Work with Tape Volumes 
Press Enter to continue to|Figure 241] App Tare VOLUME. 
@ Add Tape Volume ONDMD400 : 
1/24/98 9:36:02 
Type choices, press Enter. 
VG UME Stet caccuhen etre came va er teneansa 6 ROO001 Identifier 
Capaciey 22 tate aise) ete) Conese eae 800_ Megabytes 
Med Tae Gy Dee memrcercmc etme mur aeecan *HIC800___ 
Media device library ...... Name 
F3=Exit F12=Cancel 
7 


Figure 241. Add Tape Volume 


Press Enter to store the tape volume information and move to|Figure 242 on 
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Work with Tape Volumes ONDMD400 
1/24/98 9:36:18 


Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Option Volume Media Capacity 


TA HIC 330000000 
TAPE QIc 1200000000 
701010 QICc 525000000 
012043 REEL 160000000 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Tape Volume added. 


Figure 242. Work with Tape Volumes 


To display your addition, press F5. 


To return to the ONDEMAND Mepia ADMINISTRATION MENU, [Figure 223 on page 211 
press F3. 


To Change Tape Volume Characteristics 


To change the characteristics of a tape volume in the tape volume file, select 


option 1, Work witH Tare VoLumes from the ONDEMAND MepIA ADMINISTRATION MENu, 
Figure 223 on page 211 


When you select this option, |Figure 243 on page 223} appears. 
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Va 
Work with Media for OnDemand (WRKMEDRDAR) 


Type choices, press Enter. 


Mediiaoby penis yen renver este. cee een >*TAPVOL 
Tape-vollume, 0.6. es Ans Ge he ae *ALL 


F3=Exit F4=Prompt 
F24=More keys 


F5=Refresh  F12=Cancel 


*OPTVOL, *STGGRP, *TAPDEV... 
Identifier, generic*, *ALL... 


Bottom 


F13=How to use this display 


Figure 243. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 244} A list of volumes and their descriptions appears. 


7 


Work with Tape Volumes 


Type options, press Enter. 


1=Add 


Option 


2 


F3=Exit 


2=Change 4=Remove 5=Display 

Volume Media Capacity 

ROOOO1 ~=HIC 800000000 

TA HIC 330000000 

TAPE QIC 1200000000 

T01010 = Qic 525000000 

012043 REEL 160000000 
F5=Refresh  F12=Cancel 


1/24/98 


ONDMD400 
9:36:22 


Bottom 


~ 


Figure 244. Work with Tape Volumes 


Press Enter to continue to|Figure 245 on page 224 
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a =~ 


Change Tape Volumes ONDMD400 
1/24/98 9:36:28 
VOUMUMG Sie saree tae tc dienes tort came s arc : ROO0O1 


Type choices, press Enter. 


Gap AaGtiE ysis act eee heer ent 400 Megabytes 
Mediianty per 2.0 ee ee iets. es ota *HIC400___ 
Media device library ...... Name 


F3=Exit F12=Cancel 


a 
Figure 245. Change Tape Volumes 
You can change the fields by typing new information over what is displayed. 
Press Enter to save and confirm your changes. |Figure 246]appears. 
ie > 


Work with Tape Volumes ONDMD400 
1/24/98 9:36:41 


Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Option Volume Media Capacity 


Reeee1 ~=sdHKIC 400000000 
TA HIC 330000000 
TAPE QIc 1200000000 
T01010 QIC 525000000 
012043 REEL 160000000 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Tape Volume changed. 


eee tee ea ee ee 


Figure 246. Work with Tape Volumes 


To return to the ONDEMAND Mepia ADMINISTRATION MENU, |Figure 223 on page 211 


press F3. 
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To Remove a Tape Volume 


Use these screens to remove a tape volume from OnDemand. When you select this 
option, the first screen, |Figure 247} appears. 


i ‘ 


Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Mediiasty peck. a2. ko crit ce on esas >*TAPVOL *OPTVOL, *STGGRP, *TAPDEV... 
Tape: Vowume, ...8. ess, ee os er ae *ALL Identifier, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 247. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 248] A list of volumes and their descriptions appears. 


(- > 
Work with Tape Volumes ONDMD400 
1/24/98 9:36:41 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Option Volume Media Capacity 
ROOQO1 ~=HIC 400000000 
4 TA HIC 330000000 
TAPE QIC 1200000000 
T01010 = Qic 525000000 
012043 REEL 160000000 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Tape Volume changed. ) 


Figure 248. Work with Tape Volumes 


Press Enter to continue to|Figure 249 on page 226} CONFIRM REMOVAL OF TAPE VOLUME. 
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(a 


Confirm Removal of Tape Volume 
1/24/98 
Press Enter to confirm your choice for 4=Remove. 
Press Fl2=Cancel to return to change your choices. 


NV OUMUMO Sse toda Aienrel beers ahora oar cess TA 
Capacity ssc cys cee seen she, 2 dere ce os 330 
Mediatype: es sare: gates 3) eect eons ec ores *HIC200 


Media device library 


F12=Cancel 


ONDMD400 
9:37:07 


Figure 249. Confirm Removal of Tape Volume 


OnDemand shows you the tape volume you have selected to remove. 


If you entered the wrong data, you can change it by pressing F12 to return to the 


previous screen. Type the correct tape volume and press Enter. 


If your entry is correct, press Enter. 


The message in|Figure 250) confirms that your tape volume was removed. 


4 
Work with Tape Volumes 
1/24/98 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Option Volume Media Capacity 
ROOOO1 = HIC 400000000 
TA HIC 330000000 
TAPE QIC 1200000000 
T01010 = QIc 525000000 
012043 REEL 160000000 
F3=Exit F5=Refresh  F12=Cancel 
Tape Volume removed. 


ONDMD400 
9:37:11 


Bottom 


Figure 250. Work with Tape Volumes 
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To return to the ONDEMAND MepiA ADMINISTRATION MENU, [Figure 223 on page 211 


press F3. 


To Display a Tape Volume 


To display a tape volume that is currently in your tape volume file, select option 2, 
Work with Tape Volumes, from the ONDEMAND Mep1a ADMINISTRATION MENU, 
Figure 223 on page 211| |Figure 251]appears. 


(- > 


Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Media typeci <yians cikii cous >*TAPVOL *OPTVOL, *STGGRP, *TAPDEV... 
Tapes VoOWUMe: 1 Ao ese. eee cee ete *ALL Identifier, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
4 


Figure 251. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 252 on page 228] Work witH Tare VoLumes. A list of 


volumes and their descriptions appears. 
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a 
Work with Tape Volumes ONDMD400 


1/24/98 = 9:36:41 


Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Option Volume Media Capacity 


RQO001 = HIC 400000000 
5 TA HIC 330000000 
TAPE QIc 1200000000 
T01010 QIC 5250000000 
012043 REEL 1600000000 


Bottom 


F3=Exit F5=Refresh F12=Cancel 


Figure 252. Work with Tape Volumes 


Option 
Enter 5 (5=Display) next to the tape volume you want to display. 


Press Enter to continue to|Figure 253 


Display Tape Volume ONDMD400 
1/24/98 = 9:37:21 
VOUMG merece eatsarente erect ee rar me te tee I ROOOOL 
Capacity «25 aw. 4% 8 we ee es ee GE 400 Megabytes 
Media type <7 se a ew eons -HTC400 
Media device library .......: 
Current sequence number. .....: ) 
Tapexbytes: used ccs 6 6 te a 0 
Tape bytes deleted ........3 0 
WMapesGulllil es 29 cn 2 seuss ees co ence cee se IN Y=Yes, N=No 
TNUS@WhiliaGh ys va epen ns oe ese ierene, eel Cents 


Bottom 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 253. Display Tape Volume 


Notice this field: 


Inuse flag 
If there is a value in this field when you display the tape volume, it 
indicates that the volume is in use. 
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If a tape backup, a tape archive, or a tape object recall is not running, a 
value in this field usually indicates a tape error. 


To clear the flag, access the ONDEMAND Mep1A ADMINISTRATION Menu and 
select|“Option 52. Reset Tape” on page 247 
To return to the ONDEMAND MepiA ADMINISTRATION MENU, [Figure 223 on page 211 


press F3. 


Option 10. Work with Storage Groups 


Use this option to create, change, delete, or display a storage group. If you prefer 
to use a graphical user interface for this function, you can use iSeries Navigator 
instead. 


A storage group lets you group optical volumes to store related data, such as 


invoices, together on a set of optical volumes. You must define a storage group 
before you can add volumes to it. 


Select option 10, Work with Storage Groups, from the ONDEMAND MepIA 
ADMINISTRATION MENu, shown in|Figure 223 on page 211]|Figure 254} appears. 


(— > 


Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Media’ Type sie er vcs cs tists coe ee >*STGGRP *OPTVOL, *STGGRP, *TAPDEV... 
Storage group «<2 % <6 % as *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 254. Work with Media for OnDemand (WRKMEDRDAR) 
Press Enter to move to |Figure 255 on page 230 


To Create a Storage Group 


Use |Figure 255 on page 230}to create a storage group. 
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a 


Type options, press Enter. 


Opt Storage group Text 
i INVOICES 


Work with Storage Groups 
1/24/98 


1=Create 2=Change 4=Delete 5=Display 


LANOPT Lan Optical 


SG1 Storage Group 1 


F3=Exit F5=Refresh F12=Return 


HFS3995 LAN attached 3995 using Optical PRPQ 


OBJECTSG Object Archive Storage Group 
RDARSOPT OnDemand Default storage group 


ONDMD400 
10:34:53 


Bottom 


Figure 255. Work with Storage Groups 


Press Enter to continue to|Figure 256 


fe 


Create Storage Group 


Type choices, press Enter. 


Optical storage group......... 

Volumes full “eset: 5 s202 cc0b ce face ae 

Free space threshold % ....... 

iG Xithaes ae ex cor nee cies eter ge see meme 
empty 


F3=Exit F12=Cancel 


1/24/98 


INVOICES _ —— Name 

i Y=Yes, N=No 
95 0-99 

Invoices storage group 


ONDMD400 
10:35:00 


Figure 256. Create Storage Group 


Press Enter to save your entries and return to|Figure 257 on page 231 
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Work with Storage Groups ONDMD400 
1/24/98 10:35:58 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Storage group’ Text 


HFS3995 LAN attached 3995 using Optical PRPQ 
LANOPT Lan Optical 

OBJECTSG Object Archive Storage Group 
RDARSOPT OnDemand Default storage group 

SG1 Storage Group 1 


Bottom 
F3=Exit F5=Refresh F12=Return 
Storage group created. 


Figure 257. Work with Storage Groups 


Press F5 to display your addition. 


To return to the ONDEMAND Mepia ApMINISTRATION MENU, |Figure 223 on page 211 
press F3. 


To Change a Storage Group 


To change the characteristics of an optical storage group, select option_10, Work 
WITH STORAGE Groups from the ONDEMAND MepIA ADMINISTRATION MENU, |Figure 223 o 


age 211] Figure 258] appears, 
(- > 


Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Media type oink. cos. couse ess >*STGGRP *OPTVOL, *STGGRP, *TAPDEV... 
Storage: GrOups +s esos ees eee as *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 258. Work with Media for OnDemand (WRKMEDRDAR) 
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Press Enter to move 


co Fane 


i 
Work with Storage Groups ONDMD400 
1/24/98 10:36:02 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 
Opt Storage group Text 
HFS3995 LAN attached 3995 using Optical PRPQ 
LANOPT Lan Optical 
OBJECTSG Object Archive Storage Group 
va INVOICES Invoices storage group 
RDARSOPT OnDemand Default storage group 
SG1 Storage Group 1 
Bottom 
F3=Exit F5=Refresh  F12=Return 


Figure 259. Work with Storage Groups 


Press Enter to move to|Figure 260} which shows the characteristics of the storage 


group you have selected. 


Text 


F3=Exit F12=Cancel 


Change Storage Group ONDMD400 
1/24/98 10:36:14 
Optical storage group: ..... . . ¢ « . 3 INVOICES 
Type choices, press Enter. 
Volume; “full nesets 7 Sse. Sc ae yee y Y=Yes, N=No 
Free space threshold % ....... 80 0-99 


Invoices Storage group 


Figure 260. Change Storage Group 


You can change the fields by typing new information over what is displayed. 


Press Enter to save your changes.|Figure 261 on page 233] appears. 
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Work with Storage Groups ONDMD400 


1/24/98 10:36:39 
Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Storage group’ Text 


HFS3995 LAN attached 3995 using Optical PRPQ 
LANOPT Lan Optical 

OBJECTSG Object Archive Storage Group 
INVOICES Invoices storage group 

RDARSOPT OnDemand Default storage group 

SGl Storage Group 1 


Bottom 
F3=Exit F5=Refresh F12=Return 
Storage group changed. 


Figure 261. Work with Storage Groups 


To return to the ONDEMAND Mepia ApMINISTRATION MENU, |Figure 223 on page 211 
press F3. 


To Delete a Storage Group 


Use these screens to delete a storage group. (OnDemand stops you from deleting a 
storage group if any optical volumes are defined to it.) When you select this 
option, |Figure 262] appears. 


( > 


Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Mediatype sire tc) Seer es os ee >*STGGRP *OPTVOL, *STGGRP, *TAPDEV... 
Storage-Groups: a. % a. coke ce. te Sats *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 262. Work with Media for OnDemand (WRKMEDRDAR) 
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Press Enter to move to|Figure 263} Work wiTH STorAGE Groups. A list of storage 
groups and their descriptions appears. 


A 
Work with Storage Groups ONDMD400 


1/24/98 10:36:39 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Storage group’ Text 


HFS3995 LAN attached 3995 using Optical PRPQ 
LANOPT Lan Optical 
OBJECTSG Object Archive Storage Group 
INVOICES Invoices storage group 
RDARSOPT OnDemand Default storage group 

4 SG1 Storage Group 1 


Bottom 
F3=Exit F5=Refresh F12=Return 


Figure 263. Work with Storage Groups 


Press Enter to continue to|Figure 264 


Confirm Delete of Storage Group ONDMD400 

1/24/98 10:36:57 
Press Enter to confirm your choice for 4=Delete. 
Press Fl2=Cancel to return to change your choice. 


Optical storage group: 262.5 ¢ « .% SGl 

Volumes TUM) WeSEG 4.2 <4 wow ae ee Y=Yes, N=No 
Free space threshold % .......3 0 

MEX. eee hae he Gee Gels) ss Ghee ess, sStorage Group: 


F12=Cancel 


Figure 264. Confirm Delete of Storage Group 


OnDemand shows you the storage group you have selected to delete. 


If you entered the wrong data, you can change it by pressing F12 to return to the 
previous screen. Type the correct storage group and press Enter. 
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If your entry is correct, press Enter to confirm your request to delete. The message 
shown in |Figure 265|appears. 


(— : = 
Work with Storage Groups ONDMD400 


1/24/98 10:36:59 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Storage group Text 


HFS3995 LAN attached 3995 using Optical PRPQ 
LANOPT Lan Optical 

OBJECTSG Object Archive Storage Group 
INVOICES Invoice storage group 

RDARSOPT OnDemand Default storage group 

SG1 Storage Group 1 


Bottom 
F3=Exit F5=Refresh F12=Return 
Storage Group deleted. 


Figure 265. Work with Storage Groups 


To return to the ONDEMAND Mepia ADMINISTRATION MENU, |Figure 223 on page 211 
press F3. 


To Display a Storage Group 


To view a storage group, select option 10, Work witH StoraGE Groups from the 


ONDEMAND Mep1A ADMINISTRATION MENU, |Figure 223 on page 211] |Figure 266 o 
lpage 236] appears. 
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Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Mediatype en tices Gacssy cease >*STGGRP *OPTVOL, *STGGRP, *TAPDEV... 
Storage group: 6 4 = wie a ee *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 266. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 267 


Ve 
Work with Storage Groups ONDMD400 


1/24/98 10:37:10 


Type options, press Enter. 
1=Create 2=Change 4=Delete 5=Display 


Opt Storage group’ Text 


5: HFS3995 LAN attached 3995 using Optical PRPQ 
LANOPT Lan Optical 
OBJECTSG Object Archive Storage Group 
INVOICES Invoices storage group 
RDARSOPT OnDemand Default storage group 
SG1 Storage Group 1 


Bottom 
F3=Exit F5=Refresh F12=Return 


Figure 267. Work with Storage Groups 


Press Enter. |Figure 268 on page 237|shows you the characteristics of the storage 


group you selected. 
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Display Storage Group ONDMD400 
1/24/98 10:37:05 


Optical storage group: < = « s3.% 2 «= # HFS3995 
Volume Tull weset 26 4.5 a ew ee ew a tN Y=Yes, N=No 
Free space threshold % ........: 0 
TOXt. se es Se a we ew as a BEAN attached 3995: using Optical PRPQ 
Optical inuse flag wa 23 wus % ss = # 000001 


Bottom 
Press Enter to continue. 


F3=Exit F12=Cancel 


Figure 268. Display Storage Group 


Notice this field: 


Inuse flag 
If there is a value in this field when you display the storage group, it 
indicates that the storage group is in use. 


For any feature except Record Archive, this flag must be blank before you 
can use the storage group. For Record Archive, you can use the storage 
group when the flag is set if the storage group is being used by another 
Record Archive job. 


If there are no jobs running that use optical (such as optical backup or 
migration, optical recall, or Record Archive), the flag can indicate an 
optical error. 


Reset the flag by selecting |“Option 51. Reset Optical” on page 247|from the 


Mep1A ADMINISTRATION MENu. 


Press F3 to return to 
Option 11. Work with Optical Volumes 


Use this screen to add, change, remove, or display optical volumes. If you prefer to 
use a graphical user interface for this function, you can use iSeries Navigator 
instead. 


To begin, select option 11, Work with Optical Volumes, from the ONDEMAND MeEpIA 
ADMINISTRATION MeNu,|Figure 223 on page 211]|Figure 269 on page 238] appears. 
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Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Mediiasty pee cee Gasp eves >*OPTVOL *OPTVOL, *STGGRP, *TAPDEV... 
Optical volume «ss sie % *ALL Identifier, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 269. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to continue to the Work witH OpticaL VoLuMES screen, |Figure 270 on 


To Add an Optical Volume 


Enter a record in the optical inventory for each optical volume OnDemand can use. 
You need to add an optical volume to OnDemand before OnDemand can use it. 
Initialize each optical volume with the INZOPTVOL command (with a 
direct-attached optical library), or use the screen option on the display of the 
LAN-attached optical library console. (See your optical library’s software 
documentation for more information on initializing optical volumes and 
recommendations regarding initialization parameters such as Volume full threshold.) 


Use a unique volume name. We suggest that you establish an OnDemand naming 
convention for optical volumes, making an OnDemand volume distinguishable 
from volumes used by different applications. 
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Work with Optical Volumes ONDMD400 = 
1/24/98 10:37:25 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Opt Volume Media Capacity Storage group 
1 DIRO0001 a 
RDLANOO1 WORM 300000000 RDLAN 
RDLANOOZ WORM 300000000 RDLAN 
RDLANOO3 REWT 300000000 INVOICES 
RDLANOO4 REWT 300000000 INVOICES 
RDLANOOS5 REWT 303000000 INVOICES 
RDLANOO6 REWT 303000000 INVOICES 
RDROPTOO01 WORM 305000000 RDARSOPT 
RDROPTO002 WORM 305000000 RDARSOPT 
ail REWT 333000000 CHKSSTG 
T2 REWT 333000000 CHKSSTG 
15 REWT 333000000 CHKSSTG 
T6 REWT 333000000 CHKSSTG 
More... 
F3=Exit F5=Refresh  F12=Cancel 
7 
Figure 270. Work with Optical Volumes 
Press Enter to move to |Figure 271 
; 
Add Optical Volumes ONDMD400 
1/24/98 10:37:31 
Type choices, press Enter. 
VG UMG\ eee: souls Hea tetseca ar teens DIROOOO1 Name 
Opposite side volume ..... DIROO002 Name 
Optical media family ..... REWT REWT, WORM... 
Optical volume capacity .... 650 __ Megabytes 
Optical storage group..... HFS3995 Name 
Optical Wibrary i tye “soe es Name 
F3=Exit F12=Cancel 
f 
Figure 271. Add Optical Volumes 
Add the characteristics of both sides of the optical volume. 
Press Enter to add both volumes to OnDemand,|Figure 272 on page 240 
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Vie 
Work with Optical Volumes ONDMD400 


1/24/98 10:37:54 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Opt Volume Media Capacity Storage group 
RDLANOO1 WORM 300000000 RDLAN 
RDLANOO2 WORM 300000000 RDLAN 
RDLANOO3 REWT 300000000 INVOICES 
RDLANOO4 REWT 300000000 INVOICES 
RDLANOO5 REWT 303000000 INVOICES 
RDLANOO6 REWT 303000000 INVOICES 
RDROPT0001 WORM 305000000 RDARSOPT 
RDROPTO002 WORM 305000000 RDARSOPT 
gpl REWT 333000000 CHKSSTG 
T2 REWT 333000000 CHKSSTG 
75 REWT 330000000 CHKSSTG 
T6 REWT 330000000 CHKSSTG 


More... 


F3=Exit F5=Refresh  F12=Cancel 
Optical volumes added. 


Figure 272. Work with Optical Volumes 


Press F5 to display your addition. 


To return to the ONDEMAND Mepia ApMINISTRATION MENU, [Figure 223 on page 211 
press F3. 


To Change Optical Volume Characteristics 


Select option 11, Work witH Optica VoLumEs from the ONDEMAND MeEpIA 


ADMINISTRATION MENU, |Figure 223 on page 211]|Figure 273) appears. 


ia 


Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Media type. 30 S33 ee ee >*OPTVOL *OPTVOL, *STGGRP, *TAPDEV... 
Optical) volume: cs. 4.23 2e. se ce ce *ALL Identifier, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 273. Work with Media for OnDemand (WRKMEDRDAR) 
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Press Enter to move to|Figure 274 


‘a Work with Optical Volumes ONDMD400 a 
1/24/98 10:38:04 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 

Opt Volume Media Capacity Storage group 

2. DIROQOO1 REWT 650000000 HFS3995 
DIRODOO2 REWT 650000000 HFS3995 
RDLANOO1 WORM 300000000 RDLAN 
RDLANOO2 WORM 300000000 RDLAN 
RDLANOO3 REWT 300000000 INVOICES 
RDLANOO4 REWT 300000000 INVOICES 
RDLANOO5 REWT 303000000 INVOICES 
RDLANOO6 REWT 303000000 INVOICES 
RDROPTO001 WORM 305000000 RDARSOPT 
RDROPTO002 WORM 305000000 RDARSOPT 
al REWT 333000000 CHKSSTG 
T2 REWT 333000000 CHKSSTG 

More... 
F3=Exit F5=Refresh  F12=Cancel B, 


Figure 274. Work with Optical Volumes 


Press Enter to move to |Figure 275} which shows the characteristics of the optical 


volume you want to change. 


Change Optical Volumes 


Type choices, press Enter. 


Optical daibrary <i 2s Se eo Se 


F3=Exit  F12=Cancel 


VOMUMe ams, sascots nic mee sare ek vebesre come ars sD ROOOOL 
Opposite side volume ......... : DIROQQOO2 
Optical media family ......... 3: REWT 


Volume: Tuli! ©: sos oe Soe ee a eS ee OS N 
Opposite side volume full. ...... N 

Optical volume capacity ........ 630 
Optical storage: group . « << % « « « HFS3995__ 


ONDMD400 
1/24/98 10:38:24 


Y=Yes, N=No 
Y=Yes, N=No 
Megabytes 
Name 
Name 


TT EE eT, too 


a 
Figure 275. Change Optical Volumes 
You can change the fields by typing new information over what is displayed. 
Press Enter to save your changes. |Figure 276 on page 242|appears. 
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Work with Optical Volumes ONDMD400 
1/24/98 10:38:28 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Opt Volume Media Capacity Storage group 
DIRO0001 REWT 630000000 HFS3995 
DIROOOO2 REWT 630000000 HFS3995 
RDLANOO1 WORM 300000000 RDLAN 
RDLANOO2 WORM 300000000 RDLAN 
RDLANOO3 REWT 300000000 INVOICES 
RDLANOO4 REWT 300000000 INVOICES 
RDLANOO5 REWT 303000000 INVOICES 
RDLANOO6 REWT 303000000 INVOICES 
RDROPTO0001 WORM 305000000 RDARSOPT 
RDROPTO002 WORM 305000000 RDARSOPT 
Tl REWT 333000000 CHKSSTG 
T2 REWT 333000000 CHKSSTG 


More... 


F3=Exit F5=Refresh  F12=Cancel 
Optical volumes changed. 


Figure 276. Work with Optical Volumes 


To return to the ONDEMAND MepiA ApMINISTRATION MENU, |Figure 223 on page 211 
press F3. 


To Remove an Optical Volume 


To remove an optical volume, select option 11, Work witH OpticAL VoLumes from the 
ONDeEMAND Mep1A ADMINISTRATION MENU. |Figure 277|appears. 


(— = 


Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Media: type. 5. 2 «3 we we >*xOPTVOL *OPTVOL, *STGGRP, *TAPDEV... 
Optical volume. 3.5.0. 5. % 0% *ALL Identifier, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 277. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 278 on page 243 
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Work with Optical Volumes ONDMD400 
1/24/98 10:39:18 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Opt Volume Media Capacity Storage group 
DIROOOO1 RENT 630000000 HFS3995 
DIROOOO2 REWT 650000000 HFS3995 
RDLANOO1 WORM 300000000 RDLAN 
RDLANOO2 WORM 300000000 RDLAN 
RDLANOO3 REWT 300000000 INVOICES 
RDLANOO4 REWT 300000000 INVOICES 
RDLANOO5 REWT 303000000 INVOICES 
RDLANOO6 REWT 303000000 INVOICES 
RDROPTO0001 WORM 305000000 RDARSOPT 
RDROPTO002 WORM 305000000 RDARSOPT 
4 71 REWT 333000000 CHKSSTG 
M2 REWT 333000000 CHKSSTG 
More... 
F3=Exit F5=Refresh  F12=Cancel 
4 
Figure 278. Work with Optical Volumes 
Press Enter to continue to|Figure 279 
( Confirm Removal of Optical Volumes ONDMD400 : 
1/24/98 10:38:57 
Press Enter to confirm your choice for 4=Remove. 
Press Fl2=Cancel to return to change your choice. 
VOMIT EG Sieedec, neuer roaceu tacicen rier cyeed sured se gale 
Opposite side volume: 2... 24 2 2 2 Te 
Optical media family «<2 « =. «=. % (REWT 
Optical volume: capacity: cs. s 3 6 & 2 333 Megabytes 
Optical storage group........ . : OBJECTSG 
Optica lie libpary’s ger eycsrce: ehcet eS) ces ee 
F12=Cancel 
XX J 


Figure 279. Confirm Removal of Optical Volumes 


OnDemand shows you the optical volumes you chose to remove. (Volumes are 
removed in pairs—top and bottom volumes of the particular optical disk.) 


If you entered the wrong data, you can change it by pressing F12 to return to the 
previous screen. Enter the correct optical volume and press Enter. 


If your entry is correct, press Enter. A message appears in|Figure 280 on page 244 
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(~ Work with Optical Volumes ONDMD400 


1/24/98 10:39:00 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 


Opt Volume Media Capacity Storage group 
DIROO0O1 REWT 630000000 HFS3995 
DIROOOO2 REWT 630000000 HFS3995 
RDLANOO1 WORM 300000000 RDLAN 
RDLANOO2 WORM 300000000 RDLAN 
RDLANOO3 REWT 300000000 INVOICES 
RDLANOO4 REWT 300000000 INVOICES 
RDLANOO5 REWT 303000000 INVOICES 
RDLANOO6 REWT 303000000 INVOICES 
RDROPTO001 WORM 305000000 RDARSOPT 
RDROPTO002 WORM 305000000 RDARSOPT 


More... 


F3=Exit F5=Refresh  F12=Cancel 
Optical volumes removed. 


Figure 280. Work with Optical Volumes 


To return to the ONDEMAND Mepia ApMINISTRATION MENU, |Figure 223 on page 211 
press F3. 


To Display an Optical Volume 


To display the characteristics of an optical volume, select option 11, Work witH 
OpticaL VoLuMEs from the ONDEMAND Mep1A ADMINISTRATION MENU, |Figure 223 on 


age 211) Figure 281] appears, 


ia 
Work with Media for OnDemand (WRKMEDRDAR) 
Type choices, press Enter. 
Medita typemcrs = cnr ust se Geis >*xOPTVOL *OPTVOL, *STGGRP, *TAPDEV... 
Optical volume... 6% 3. se co en *ALL Identifier, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 281. Work with Media for OnDemand (WRKMEDRDAR) 


Press Enter to move to|Figure 282 on page 245 
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Work with Optical Volumes ONDMD400 
1/24/98 10:39:18 
Type options, press Enter. 
1=Add 2=Change 4=Remove 5=Display 
Opt Volume Media Capacity Storage group 
DIROOOO1 REWT 630000000 HFS3995 
DIROOOO2 REWT 630000000 HFS3995 
5 — RDLANOO1 WORM 300000000 RDLAN 
RDLANOO2 WORM 300000000 RDLAN 
RDLANOO3 REWT 300000000 INVOICES 
RDLANOO4 REWT 300000000 INVOICES 
RDLANOO5 REWT 303000000 INVOICES 
RDLANOO6 REWT 303000000 INVOICES 
RDROPTO0001 WORM 305000000 RDARSOPT 
RDROPTO002 WORM 305000000 RDARSOPT 
al REWT 333000000 CHKSSTG 
2 REWT 333000000 CHKSSTG 
More... 
F3=Exit F5=Refresh  F12=Cancel 
ZS 
Figure 282. Work with Optical Volumes 
Press Enter to continue to|Figure 283 
( Display Optical Volumes ONDMD400 y 
1/24/98 10:39:10 
VOwliUIMes encase newborn ueecsy Cecten se pewncuien (oaleress RDLANOO1 
VoiUMenthUlil rep esa: ote: cc scutes een san ses - N Y=Yes, N=No 
BYt@S SCG! soc: os Ces, wirive tercen ee ue 30,056,192 
Bytes deleted): c.c5. sis. ee ccwee, sees: os 0 
Opposite side volume ........32 RDLANOO2 
Mouiumenciulil ese) Re ce wes ce ae : N Y=Yes, N=No 
Bytes sed) ces cies ty tes boa ceacn cers 15,299,328 
Bytes delietedi.s = os. a: a os veaceeset yess. ce 0 
Opticaliimedita familly: os <2. Wee ee se cs WORM 
Optical volume capacity. . 2 4.2.4 6% 300 Megabytes 
Optical storage: groups. 2 ese RDLAN 
Optica library’ sce savas. ices ieee cee LAN3995 
Bottom 
Press Enter to continue. 
F3=Exit F12=Cancel 
“4 


Figure 283. Display Optical Volumes 


To return to the ONDEMAND Mepia ADMINISTRATION MENU, |Figure 223 on page 211 
press F3. 


Option 20. Optical Support Menu 


Use this option to move to the OS/400 OprticaL Support Utiuities menu. (Refer to the 
OS/400 Optical Support manual for information on the particular menu options.) 
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Option 21. Work with Communications Side Information (LAN Attached 
Optical Only) 


The IBM 3995 Optical Library Dataserver LAN attached models’ communications 
interface is controlled by OS/2 communications. Therefore, you must customize 
the PS/2® controller to enable the 3995. (See the appropriate manual for 
information on this procedure.) 


After you complete the OS/2 configuration, ensure that you have defined the 
correct OS/400 communications side information. 


Select option 21, Work with Communications Side Information (LAN Attached 


Optical Only) from |Figure 223 on page 211}and press Enter to accept the defaults 
on the resulting screen. Alternately, type WRKCSI on the OS/400 command line to 


view the default entry shipped with OnDemand. 


Press Enter to display |Figure 284 
f * 


Work with Communications Side Information 


Type options, press Enter. 
l=Create 2=Change 4=Delete 5=Display 6=Print 


Side 
Opt Info Library Text 
5 ~~ QRLCOPT QRDARS CPI Communications side information for 3995 


Bottom 
Parameters for options 1, 2 and 5 or command 
===> 
F3=Exit F4=Prompt F5=Refresh F9=Retrieve F11=Display names only 
F12=Cancel F16=Repeat position to F17=Position to 


Figure 284. Work with Communications Side Information 


Press Enter to display more information in|Figure 285 on page 247 
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Display Comm Side Information 


Stdesainitormation) soa we. & ea wt CORECOPRT 
[et eaves. eaten Covmetnre Wh adccrnssa vee eee ss : QRDARS 
Remote: Vocation. 25) <2. sen cs es LU3995X 
Transaction program. <.. =. =~. HFSSRY 
DEViICG ne, ea ee we Sep we LOE 
Local MoGakton ss. sou, co ces Velen ae ce *LOC 
Moder ee ere ree otek setop eed s ukeen trast csen BLANK: 
Remote network identifier... . :  APPN 
TOXt. 6 ee ee ew we ee wt ee CPL Communications side: information for 3 
995 


Press Enter to continue. 


F3=Exit  F12=Cancel 


Figure 285. Display Comm Side Information 


The information shown matches some of the OS/2 communications configuration 
values. To change any of these fields, select option 2 in |Figure 284 on page 246 
(The Remote network identifier field —RMTNETID—is the field usually changed. It 


should match the Local Network ID of the iSeries. This value can be determined by 
using the Display Network Attributes (DSPNETA) command. 


Option 40. Main Menu 
Use this option to return to the OnDemand Main Menu, |Figure 222 on page 210 


Option 51. Reset Optical 


This option clears all storage group in-use flags and checks the space on all 
OnDemand optical volumes. This option appears only if the user has *ALL 


authority at the OnDemand application level. (To grant this authority, see[“Option| 

10. Edit/ Authorize OnDemand Users” on page 56}) 

You should not run the reset option while the Report Management Cycle (for Spool 
File Archive) or the Object Management Cycle (for Object Archive) is running. This 


reset option could cause some optical volumes or all optical volumes that are 
known to OnDemand to mount to check for space. 


Option 52. Reset Tape 


This option clears all in-use flags for tape volumes and tape devices. This option 


appears only if the user has *ALL authority at the OnDemand application level. 
To grant this authority, see|“Option 10. Edit/Authorize OnDemand Users” on| 
bane 54) 


You should not run the reset option while the Report Management Cycle (for Spool 
File Archive) or the Object Management Cycle (for Object Archive) is running. 
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Chapter 7. Integrating OnDemand with Content Manager 


IBM Content Manager for iSeries (Content Manager) (formerly known as IBM 
ImagePlus® VisualInfo'", VI/400) is a feature-rich image application which 
provides extensive workflow capabilities. Integration of OnDemand archived 
reports into Content Manager allows a single method for viewing both images and 
archived OnDemand reports from a single workstation application. This chapter 
explains the benefits of integration, how to accomplish integration, and how to use 
the features of the integration software. 


Overview of OnDemand and Content Manager Integration 


When using OnDemand and Content Manager, there are times when related 
information exists in both applications. For example, you may want to relate 
images of insurance claims to a check register of claims paid. In this and many 
other examples, users need to be able to search for and view both the images and 
archived spooled files (COLD documents). You need two different workstation 
clients to search for and view Content Manager images and OnDemand COLD 
documents, each with its own interface and different search capabilities. Using the 
integration software, you only need the Content Manager Client to access both 
images and archived spooled files. The full benefits of this integration also include 
the following: 


* Combined routing of internally generated reports and scanned documents. 
* Full support of image workflow. 
* Transparent handling of documents in work packages. 


Content Manager External Reference Support 


Content Manager is now able to allow its indexes to point to data that resides 
outside of Content Manager by using external data references. This allows Content 
Manager to capture key values for data sources that exist in other iSeries and 
workstation applications. When the Content Manager Client retrieves data from an 
external data source, it can do the following tasks: 


* Retrieve the data and pass it to the Content Manager Client for viewing. 


* Call an iSeries program to retrieve the data and pass it to the Content Manager 
Client. 


* Launch a PC-based application, such as Lotus® 1-2-3® or Microsoft® Word. 


OnDemand provides external data references that allow Content Manager to 
retrieve OnDemand archived spooled files. This means that you can use one Client 
to view both images and COLD documents. When searching the Content Manager 
databases, the system presents a combined hitlist of OnDemand documents and 
Content Manager images to the user. Users will only need to know how to use the 
Content Manager Client. 


How OnDemand Uses Content Manager External Data 
References 


OnDemand now provides two methods for creating external data references for 
Content Manager: 


1. When you archive spooled files by using OnDemand, you can create external 
data references. You can do this by specifying a new index exit program in the 
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appropriate OnDemand report definition. When a report is archived, the new 
exit program (QRLWEXITV, or QRLWEXITVM if any of the keys or display 
fields are Multi-key fields) is called. Once called, the program creates external 
data references in an interface file for Content Manager. The system uses a 
report definition extension record to map index data from an OnDemand report 
definition to a Content Manager index class. Use the WRKADMRDAR 
TYPE(*RPTEXT) command to maintain report definition extension records. 


Report data can reside on any media including disk, optical, or tape. Do not 
migrate your OnDemand report indexes to optical or tape for reports 
integrated into Content Manager. Check your Migration Policy to confirm that 
you are not migrating index records. If you choose to have the Report 
Management Cycle migrate the indexes to optical or tape, an entry in the 
Content Manager search list will appear. However, when you request to display 
it, the system cannot retrieve the segment (object). If you only need to know 
that it did exist at some time, then this may be sufficient. However, if you need 
to view these items, you must leave the indexes on disk for the life of the 
report. 


2. For reports that were previously archived in OnDemand, another command has 
been provided (ADDVIRDAR) which creates external data references in an 
interface file for Content Manager. OnDemand uses a report definition 
extension record to map index data from an OnDemand report definition to a 
Content Manager index class. Use the WRKADMRDAR command to maintain 
report definition extension records. To insure that external references are 
automatically removed from Content Manager when they are expired in 
OnDemand, specify one of the new index exit programs (QRLWEXITV or 
QRLWEXITVM) in each affected report definition. 


Once you create an external data reference, you must call a Content Manager 
program (QVIXRFINX) to load the external references into Content Manager from 
the interface file. After this program finishes, you can retrieve OnDemand spooled 
files by using the Content Manager Client. The Content Manager Client will launch 
the AFP Viewer to display the OnDemand archived spooled files. 


How OnDemand External References are Removed from 
Content Manager 


IBM provides three methods for removing OnDemand external references from 
Content Manager: 


1. OnDemand automatically expires (deletes) archived reports as they age, based 
on a report’s migration policy. When an integrated report expires, the system 
marks the corresponding external reference records for deletion in the Content 
Manager interface file. Note that this is only true if the OnDemand report 
definition for that report/version combination has one of the new index exit 
programs (QRLWEXITV or QRLWEXITVM) specified. 


2. The OnDemand Delete Report command marks external reference records for 
deletion when you use it to delete an archived spooled file as long as the index 
exit program is specified in the report definition for the affected report/version. 


3. Anew command (RMVVIRDAR) marks external references for deletion in the 
Content Manager interface file. This command does not delete OnDemand 
archived reports. The command, by default, calls the Content Manager program 
(QVIXRFDEL) to remove the external references from Content Manager. 


After marking external data references for deletion, you must call a Content 
Manager program (QVIXRFDEL) to remove the external references from Content 


Manager and the interface file. When this program runs, it deletes all external 
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references from Content Manager. Even if you re-index an external reference or put 
it on a workflow, the system will delete the external reference and all of its 
associated Content Manager annotations and notes. 


Installing the Integration Software 


To install the OnDemand and Content Manager integration software, perform the 
following steps: 


Step 1. Verifying Software Prerequisites 


The following software is required in order to perform the integration of 
OnDemand with Content Manager: 


* OnDemand Spool File Archive feature. 
* Content Manager Client V5R1. 
¢ Microsoft Windows 2000, Windows 95, Windows NT 4.0, or Windows XP. 


¢ Advanced Function Presentation (AFP) Viewer. This utility is included with the 
iSeries Access product (5722-XE1), as part of the OnDemand Client, or as a 
standalone product (the AFP Workbench). 


Step 2. Granting authority to Content Manager External 
Reference Files 


You must grant authority to add and change records in the files to the 
QRDARS400 user profile. 


Use the following commands to grant the proper authority to the correct data 
libraries and files: 


GRTOBJAUT OBJ(QSYS/xxxx) OBJTYPE(*LIB) USER(QRDARS400) 
AUT(*CHANGE) 

GRTOBJAUT OBJ(xxxx/EKD0313) OBJTYPE(*FILE) USER(QRDARS400) 
AUT(*CHANGE) 

GRTOBJAUT OBJ(xxxx/EKD0314*) OBJTYPE(*FILE) USER(QRDARS400) 
AUT(*CHANGE) 


where xxxx is the Content Manager data library. 


You can repeat these commands for additional Content Manager environments by 
using different Content Manager data libraries. 


Step 3. Updating the Content Manager Job Description 


Use the work job description command (WRKJOBD) to update the Content 
Manager initial library list parameter (INLLIBL) to include the QRDARS library. 
For Content Manager Version 5 Release 1, the default job description is QVIJOBD 
in library QUSRVI. 


If you are using multiple Content Manager environments, you will need to add 
QRDARS to the initial library list of each job description for each Content Manager 
environment. 


If you install OnDemand by using a secondary language, put the library for the 


secondary language in the library list. For example, library QSYS2924 is for upper 
and lowercase English. 
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Note: You must stop and restart the Content Manager server jobs to begin using 
the updated job description. 


Step 4. Updating the QRDARS400 Job Description 


Use the work job description command (WRKJOBD) to update the OnDemand 
initial library list parameter (INLLIBL) to include the appropriate Content Manager 
data library. By default, OnDemand commands submitted for batch processing use 
the QRDARS/QRDARS400 job description. To find the external reference files, the 
library containing the external reference files must be in the initial library list of 
the QRDARS/QRDARS400 job description. 


Note: You must stop OnDemand report monitors and restart them again to begin 
using the updated job description. 


Step 5. Configuring the Content Manager Client to Launch the 
AFP Viewer 


The Content Manager Client provides support to launch other PC-based 
applications to view external data. This information is specified on the Alternate 
Viewer tab within the Content Manager client’s Preferences window. To reach the 
Alternate Viewer tab while using the Content Manager client, select the Options 
pulldown menu, then select Preferences, then click on the Alternate Viewer tab. To 
add an alternate viewer for OnDemand spooled file data, click the Add button. 
When the Edit/Add window is displayed, type ‘afp’ (without the quotes) in the 
File Extension field and select AFP from the pulldown. (You use the ‘afp’ 
designation for all OnDemand spooled files, even if the spooled files are not AFP.) 
The interface type should be set to OLE Embedding. Then click OK. Click OK 
again at the Preferences window to return to the Content Manager client window. 
You should now be able to view integrated OnDemand archived spooled files 
using the Content Manager client. 


Note: If you are integrating AnyStore data, such as PC files, you would follow the 
same process, specifying the PC file type in place of ‘afp’ in the instructions 
above. 


Verifying Installation 
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To verify successful installation of the integration software, you must perform the 
following tasks: 


Step 1. Creating an OnDemand Report Definition 


Complete the following steps to create an OnDemand Report Definition: 
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ie ; 
MAIN 0S/400 Main Menu 
System: SYS400C4 
Select one of the following: 


. User tasks 

. Office tasks 

. General system tasks 

. Files, libraries, and folders 
. Programming 

. Communications 

. Define or change the system 

. Problem handling 

. Display a menu 

Information Assistant options 
Client Access/400 tasks 


FPOWOONDA OAR WNE 


Pe 


90. Sign off 


Selection or command 
===> GO ONDEMAND 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
F23=Set initial menu 


Figure 286. OS/400 Main Menu 


To begin working with OnDemand, type GO ONDEMAND on the OS/400 
command line and press Enter. 


( ae a 
ONDEMAND OnDemand for iSeries 
System: SYS400C4 
Select one of the following: 
1. Report Administration Menu 
2. Object Administration Menu 
3. Record Archive Menu 
4. Media Administration Menu 
90. Sign off 
Selection or command 
See> 7]: 
F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
F23=Set initial menu 
/ 


Figure 287. OnDemand Report Administration Menu 


To create the installation verification report definition, select option 1 from the 
Report ADMINISTRATION MENu and press Enter. 
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RDARSRPT OnDemand Report Administration Menu 
Select one of the following: 


1. Retrieve Reports 

2. Work with Report Policies 

3. Work with Report Overlays 

4, Work with Report Definitions 

5. Work with Report Groups 

6. Work with Report Definition Extensions 


10. Edit/Authorize OnDemand Users 

11. Edit/Authorize OnDemand Report Users 

12. Edit/Authorize OnDemand Report Group Users 
13. Work with Key Security 


20. Report Definition Menu 


Selection or command 
S==>..4 


System: SYS400C4 


More... 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=Information Assistant 
F23=Set initial menu 


Figure 288. Work with OnDemand Report Definitions Panel 1 


Select option 4, Work with Report Definitions, and press Enter. 


te 
Work with Admin for OnDemand (WRKADMRDAR) 
Type choices, press Enter. 
Administrator function. .... > *REPORT *REPORT, *RPTGRP, *RPTOVL... 
Report, names <2 42 se Sey ree ce *ALL Name, generic*, *ALL... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Bottom 


Figure 289. Work with OnDemand Report Definitions Panel 1 


Press Enter to continue. 
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(F ; ae > 
Work with Report Definitions SYS400C4 
6/21/99 15:30:45 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Report Version Type Text 


3 TSTINV 01 DOC Test Invoices (OnDemand Sample) 


Bottom 


F3=Exit F5=Refresh  F12=Cancel 
i ES 7 


Figure 290. Work with OnDemand Report Definitions List Panel 1 


The list of existing OnDemand report definitions displays. 


Use Option 3 to copy the sample TSTINV report definition. 


ie ee e. 
Copy Report Definition SYS400C4 
6/21/99 15:30:45 
To rename copied report, type New report, press Enter. 
Report Version New report New version 
TSTINV 01 INVOICETST 01 
Bottom 
F3=Exit F12=Cancel 
yo 


Figure 291. OnDemand Report Definition Copy Panel 


Name the new report definition INVOICETST, version 01, and press Enter. 
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(— > 


Work with Report Definitions SYS400C4 
6/21/99 15:30:45 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Opt Report Version Type Text 
2 INVOICETST 01 DOC Test Invoices (OnDemand Sample) 
TSTINV 01 DOC Test Invoices (OnDemand Sample) 


Bottom 
F3=Exit F5=Refresh  F12=Cancel 


ac A ee 


Figure 292. Work with OnDemand Report Definitions List Panel 2 


Press F5 to refresh the report definition list. The INVOICETST report definition 
will now appear in the list. 


You must change the new INVOICETST report definition to use the QRLWEXITV 
program. The QRLWEXITV exit program adds OnDemand key values into a 
Content Manager interface file for later loading into Content Manager as an 
external reference. 


Enter 2 in the option field in front of the INVOICETST report definition and press 
Enter. 


fa ~ 


Select Report Section to Change SYS400C4 
6/21/99 15:30:45 


Type selection, press Enter. 
1=Select 


Choose Section 
1 Environment 
Segmentation 
Keys 
All sections 


Bottom 


F12=Cancel 


F3=Exit 
See eS 


Figure 293. OnDemand Report Definition Change Panel 1 
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Select the environment section of the report definition for update, using option 1, 
and press Enter. 


( Change Report Definition - Environment SYS400C4 +) 
6/21/99 15:30:45 
Report/ Versions. 2 s,m ce cel eee) es Seu ay eg et INVOICETST / 01 
Type choices, press Enter. 
REpORmt type. ives, Se ee se foc eer ci ton tones? ot vot erate ts DOC DOC, PAGE 
ODX, UBND 
Input: record’ length << <3. ~ w= 4.2 eS 111 20-256 
POlCysmame: Bene Aone ce heres canto ee ai eeeteat ste RDARSTEST ame 
Reportoverlay coc cei. tn uke ee shoe te tucnns ame 
Report data types 35 Ss wee we RS A *OTHER *LINE, *AFPDS 
*OTHER... 
REPORE iGMOUP) Ay tec oer. mod or erent ss 73 fein ve. boc wet xe ame 
Translate print control of si %. ni & 4 Nese N Y=Yes, N=No 
PytinbOre shiilieh ve ees ey. ee enna tay ae eee nee ce iee TSTINVPRTF ame 
END RaNYjoese eoresnes orcacss oeee epee ess hock eee QRDARS 
Me Xba hderacetem ranet kc vcies emesis nance coumomee Sceacamclire Test Invoices 
(OnDemand Sample) 
COMPVESSTON eee eee eee cee ae peee spear oe) feucen ees eae Y Y=Yes, N=No 
Postindadatectype: as. ois ce sere steele ae 
More... 
F3=Exit F12=Cancel 


Figure 294. OnDemand Report Definition Change Environment Panel 1 


The first screen requires no changes. Press the Page Down key to advance to the 
next screen. 


Note: If you specified a Posting date type, another screen would follow the screen 


shown above. You would then need to 
time to advance to the screen shown in 


press the Page Down key a second 
Figure 295 


fe 
Change Report Definition - Environment SYS400C4 *) 
6/21/99 15:30:45 
Report /Versionincss ses Grice ets eras INVOICES ./201 
Type choices, press Enter. 
Bypass report results display ........ N Y=Yes, N=No 
Bypass document results display ....... N Y=Yes, N=No 
Search all sequence numbers ......... N Y=Yes, N=No 
AN PULS OTs 5 Stekeen ese Se ieee Uo, ceacss bey rse cot cen eh er sre Name 
END a Viapres cutee ges erercusce on-camera crue tecatene cur same rs 
WIN EX COXA ties Sy eon eee een eae eet ae Sek sees we QRLWEXITV Name 
EID Wai V4 es cee oss toner oe tomers rem eras te QRDARS 
VACWOROXdLES MeGronyenuceneasca car dees ones termes eer ee Name 
EMDR ANY Sere cel he es eee Sues et ee es cee ee eis 
Bottom 
F3=Exit F12=Cancel 
J 
Figure 295. OnDemand Report Definition Change Environment Panel 2 
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Enter program name QRLWEXITV in the INDEX Exit program name field. Enter 
library QRDARS in the library name field. 


Note: Be sure to spell this program name correctly, and enter this information in 
the correct exit field. 


Step 2. Setting up a Content Manager Index Class 


To integrate an OnDemand report with Content Manager, a corresponding Content 
Manager index class must already exist. To create a Content Manager index class 
for the installation verification test, perform the following steps: 


he x 


VI Content Manager for iSeries 
Select one of the following: 

1. Profile maintenance 

2. Work with storage management jobs 


3. Database utilities 


90. Sign off 


Selection or command 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=User support 
Fl6=Set initial menu 


EE 


Figure 296. Content Manager Main Menu 


Sign on using a Content Manager administrator user profile. 


Select option 1 and press Enter to perform profile maintenance. 
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VIPRF Profile Maintenance 
Select one of the following: 


. Work with privilege sets 

. Work with user profiles 

. Work with groups 

. Work with access lists 

. Work with key fields 

. Work with index classes 

. Work with workbaskets 

. Work with policies 

. Work with servers 

10. Work with object directories 
11. Work with storage classes 
12. Work with optical systems 
13. Delete work management profiles 


OONDNTAHPWNHEHE 


Selection or command 
===> 5 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User support 
Fl6=Set initial menu 


Ss 4 
Figure 297. Content Manager Profile Maintenance Menu 
Select option 5 and press Enter to work with key fields. 
a 
Work with Key Fields : 
POSiENON EOns a tee oe Key field 
Type choices, press Enter 
l=Create 2=Change 3=Copy 4=Delete 5=Display 
Key 
Option Field Text 
1 INVNBRO3 
oe DOCDESC Document description 
2 DOCTYPE Document type 
= IDENTIFR Folder identifier 
a SOURCE Source 
a TMESTAMP Time stamp 
~ USERID User ID 
Bottom 
F3=Exit F5=Refresh  F12=Cancel ee, 


Figure 298. Content Manager Work with Key Fields Panel 1 


1. Type 1 in the option column of the first line displayed. 


2. Type INVNBRO3 in the Key Field column of the first line displayed and press 


Enter. 
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fe 
Create Key Field 


Type choices, press Enter 


Key Teddi a Secs. Ye: css) mene) feu cots INVNBRO3 Name 

MOXE eee sey ie eee fon Ger Ge vetee “et sen eh ce Invoice Number 

iILY, DORreacsupemerstts Merisctre mcr cece creda: sf 1=Character 
2=Numeric 

Depo hel (ubtearR armen sey eer ecemra sonra 03 1-40 


More... 


F3=Exit F12=Cancel 


Figure 299. Content Manager Create a Key Field Panel 


3. Fill in the key field information as shown above for the INVNBRO3 field and 
press Enter. 


4. Add 5 more key fields, repeating the steps from|Figure 298 on page 259} and 


Use the following information to build the five additional keys: 
* Field name "CUSNBRO4", Description "Customer Number”, Type 1, Length 4. 
* Field name "SLSMANO5", Description "Salesman", Type 1, Length 5. 
* Field name "INVTOT12", Description "Invoice Total”, Type 1, Length 12. 
* Field name "ORDNBRO7", Description "Order Number", Type 1, Length 7. 
* Field name "REPTDATE", Description "Report Date", Type 1, Length 8. 
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VIPRF Profile Maintenance 
Select one of the following: 


. Work with privilege sets 

. Work with user profiles 

. Work with groups 

. Work with access lists 

. Work with key fields 

. Work with index classes 

. Work with workbaskets 

. Work with policies 

. Work with servers 

10. Work with object directories 
11. Work with storage classes 
12. Work with optical systems 
13. Delete work management profiles 


OONDNTAHPWNHEHE 


Selection or command 
===> 6 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User support 
Fl6=Set initial menu 


Figure 300. Content Manager Profile Maintenance Menu 


Press F12 to return to the Profile Maintenance menu. Select option 6 and press 
Enter to work with index classes. 


i S 


Work with Index Classes 
POSTMAN CO: te, a. fea teese Index class 


Type choices, press Enter 
l=Create 2=Change 3=Copy 4=Delete 5=Display 


Index 
Option Class Text 
1 INVTEST 


DOCCLASS Non-indexed documents 
FLRCLASS Non-indexed folders 
NOINDEX To be indexed items 


Bottom 


F3=Exit F5=Refresh F12=Cancel 


Figure 301. Content Manager Work with Index Classes Panel 


Type 1 in the Option column on the first available line. 


Type INVTEST in the Index Class column on the first line that is available and 
press Enter. 
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Create Index Class 
Type choices, press Enter 
ANEX A CllaSSaors we esans uceces ceases ten Yea renee os INVTEST ame 
IL CXiUoteatoab one soem onc atcemcn come retreat Sic Invoice Test Report 
INCCESSilil'S timere ances ancmbeuerectency evausspap ren USER Name, F4 for list 
Keys fielidy ils 7. 35 Gok owe ee, So ced er es INVNBRO3 ame, F4 for list 
REQUsNedi ner se ccs usu stateiece meee sue vslmen acres N Y=Yes, N=No 
Key aiitie lide Zee cs atetrss nuts trace eu retin var: CUSNBRO4 ame, F4 for list 
REQUIMEG tem serce so teteyeoe ccs vepdon st ueaneine N Y=Yes, N=No 
Key aitedidieSiy Ate oieron swcsse-srassuees nested res SLSMANO5 ame, F4 for list 
Reguiinedinee sarc eet ieisce cat epastuaneeateies N Y=Yes, N=No 
Keyshia lidicd! oo. ra teciros seutsie-sca sue tes netined fries INVTOT12 ame, F4 for list 
Reguiinedine: soc: ste ieysce cc: vende cal sonnets N Y=Yes, N=No 
More... 
F3=Exit F4=Prompt F6=Create key field F12=Cancel 


Figure 302. Content Manager Create Index Class Panel 1 


Fill in the Create Index Class screen as shown and press the Page Down key. 


Note: You must choose an appropriate Access list from the lists available on your 
system. 


TT TTT nt ee a. 


Create Index Class 


Type choices, press Enter 


Keys tie lidi5= 3. i esutss eausd oy incu boneeden te ORDNBRO7 ame, F4 for list 
REqQuiimedi tei vce rsa asst svuses conecensau eters N Y=Yes, N=No 

Keys ie ldinG et. ot ital caused cis vu pcueeeden te REPTDATE ame, F4 for list 
Requimediecverrer arco steers comecaesat ers N Y=Yes, N=No 

Keyed," St. ook sales esd ce ieveupemeedsy. ts ame, F4 for list 
REQUINEG! zeus Ses wns icee o> Soave den cs es 4 Y=Yes, N=No 

Keys tie lidh:Bi =. oe) ten caused 2 iv ecwe sy ce ame, F4 for list 
REQUINEG 2 10 ie Ape seh cee See Seas ted es es 2 Y=Yes, N=No 

Key field to 


represent. object: . a2 % % sa & « 


More... 


F3=Exit F4=Prompt F6=Create key field F12=Cancel 


Figure 303. Content Manager Create Index Class Panel 2 


Fill in the Create Index Class screen as shown and press Enter. 


Step 3. Creating OnDemand Report Definition Extensions 


The following steps and screens show an example of the Report Definition 
Extensions. The extensions contain information regarding the relationship between 


262 IBM Content Manager OnDemand for iSeries: Administration Guide 


OnDemand report segments and Content Manager, such as the correspondence 
between OnDemand key values and the Content Manager index class and index 
fields. 


You must add the Content Manager data library and program library to your 
library list before proceeding. The data library should appear before the program 
library in the library list. By default, the data library is QUSRVI, although you may 
have a different data library in your environment. The program library is QVI. If 
you fail to add either library to the library list, you will receive an error message. 


™~ 


fo 
RDARSRPT OnDemand Report Administration Menu 
System: SYS400C4 
Select one of the following: 


1. Retrieve Reports 

2. Work with Report Policies 

3. Work with Report Overlays 

4, Work with Report Definitions 

5. Work with Report Groups 

6. Work with Report Definition Extensions 


10. Edit/Authorize OnDemand Users 

11. Edit/Authorize OnDemand Report Users 

12. Edit/Authorize OnDemand Report Group Users 
13. Work with Key Security 


20. Report Definition Menu 
More... 
Selection or command 
===> 6 


F3=Exit F4=Prompt F9=Retrieve  F12=Cancel F13=Information Assistant 
F23=Set initial menu 


Figure 304. OnDemand Report Administration Menu 


From the ONDEMAND Report ADMINISTRATION MENU, select option 6, Work with Report 
Definition Extensions, and press Enter. 
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Work with Admin for OnDemand (WRKADMRDAR) 
Type choices, press Enter. 
Administrator function. .... > *RPTEXT *REPORT, *RPTEXT, *RPTGRP... 
Report extension name ..... *ALL Name, generic*, *ALL... 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 305. Work with Administration for OnDemand 
Press Enter. 


You may also use the WRKADMRDAR command from any command line and 
specify the parameter TYPE(*RPTEXT) and RPTEXT(*ALL) as shown below: 


WRKADMRDAR TYPE(*RPTEXT) RPTEXT(*ALL) 


The following screen displays: 


6/01/99 Report Definition Extensions for CM for iSeries QSECOFR 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Report Report CM for iSeries 
Opt Name Version Index Class 
1 INVOICETST 01 


Bottom 


F3=Exit F5=Refresh F12=Return 


Figure 306. Report Definition Extensions List Panel 


To create a new Report Definition Extension record: 
1. Type 1 (for Create) in the Opt column on the first line displayed. 
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2. Type INVOICETST in the Report Name field. 
3. Type 01 in the Version field. 
4. Press Enter to continue to the next panel. 


For_more details of each field, see the command description for WRKADMRDAR 
in|/“OnDemand and Content Manager Integration Commands” on page 267] or 


press the F1 key for help. 


i ae > 

6/15/99 Update OnDemand Report Definition Extensions QSECOFR 

OnDemand Report Name: INVOICETST 

OnDemand Report Version: 01 

OnDemand Report Description: Test Invoices (OnDemand Sample) 

CM for iSeries Index Class: INVTEST 

CM for iSeries Content Class: 0303 

F3=Exit F12=Return 
24 


Figure 307. Create Report Definitions Extensions Panel 1 


This screen is used to relate an OnDemand report/version to a Content Manager 
index class. 


The content class will be determined by the OnDemand report type and report 
data type (and object class, for AnyStore data). For spooled files and most 
AnyStore data, OnDemand will set this value for you. For AnyStore data with 
object class of 255 (user-defined data), the content class cannot be determined and 
must be entered on this screen. See the EKD0318 file for valid Content Manager 
content classes that can be entered here. 


Enter INVTEST in the index class field and press Enter. 
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[@ 
6/15/99 Update OnDemand Report Definition Extensions QSECOFR > 
OnDemand Report Name: INVOICETST 
OnDemand Report Version: 01 
OnDemand Report Description: Test Invoices (OnDemand Sample) 
CM for iSeries Index Class: INVTEST Desc.: Invoice Test Report 


CM for iSeries Content Class: 0303 
2nd Level Index Exit: 
2nd Level Exit Lib: 


Specify 
OnDemand Key Fields Key Relationships CM for iSeries Key Fields 
1 Invoice No. = 1 Invoice Number 


2 Customer No. Customer Number 
3 Salesman Salesman 

4 Invoice Total Invoice Total 

5 Order# 


6 Report Date Report Date 


Lob 1OAOr BI WIN! 


1 
2 
3 
4 
5 Order Number 
6 
7 
8 


ONO WP 


F3=Exit F12=Return 


na Ee 


Figure 308. Create Report Definition Extension Panel 2 


Use this screen to describe the relationship between OnDemand report keys and 
Content Manager index class keys. 


The example above maps all six OnDemand keys to Content Manager. In the 
verification test this is a straight mapping of keys. This is because the example 
created the Content Manager index class with all of the OnDemand keys. In most 
cases, Content Manager index classes will already exist, and you will be mapping 
to index class keys that are in different sequences. An index class may have more 
or fewer keys than the OnDemand report definition. It is also possible to map one 
OnDemand key to more than one Content Manager key. 


Step 4. Starting Report Store Processing 
To start Report Store processing, perform the following steps: 
1. Ensure that the Content Manager data library is in your library list. 


2. Issue the Copy File command (CPYF) to generate a spooled file to archive as 
shown below: 
CPYF FROMFILE(QRDARS/TSTINV) TOFILE(QRDARS/TSTINVPRTF) 
3. Issue the Work with Job command (WORKJOB). Then use option 4 to get the 
spooled file’s job name, user, number, and the spooled file number to use in the 
next step. 


4. Issue the Start Coded Data Store command (STRCDSRDAR) for the report as 
shown below. However, you must insert the correct values for the JOB and 
SPLNBR parameters (as determined by using WRKJOB above): 


STRCDSRDAR REPORT(INVOICETST) VERSION (01) 
SPLF(TSTINVPRTF) JOB(000001/USERID/JOBNAME) SPLNBR(1) 


Step 5. Running the Content Manager External Reference 
Load Program (QVIXRFINX) 


Ensure that the Content Manager data library and Content Manager library 
containing QVIXRFINX is in your library list. 
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Run the Content Manager external reference index load program to add the 
OnDemand report references into the Content Manager databases. Use the 
following call command to run the external reference load program: 


CALL PGM(QVIXRFINX) 


The QVIXRFINX program will load all unprocessed external data references into 
Content Manager. For this reason, it may be run at any time to integrate 
OnDemand report indexes. It is recommended that you run this program 
periodically, perhaps using a job scheduler. 


Step 6. Retrieving an OnDemand Report Segment from the 
Content Manager Client 


From a Content Manager Client workstation, log on to the Content Manager Client 
and select the Invoice Test index class for searching. 


Select any segment for retrieval and the Advanced Function Print Viewer should 
launch and display a segment of the test report. 


Note: You must authorize the users to use OnDemand and to the OnDemand 
reports that they are retrieving. You can accomplish this by using options 10 
and_11 on the OnDemand Report Administration Menu, shown in|Figure 288 


OnDemand and Content Manager Integration Commands 


This section describes how to run the commands provided with the integration 
software. Content Manager was formerly known as VisualInfo and the abbreviation 
VI is still used in the commands. 


Add to CM for OnDemand (ADDVIRDAR) command 


ie > 
Add to CM for OnDemand (ADDVIRDAR) 
Type choices, press Enter. 
Report: name: 7 go. oe es ee Sas INVOICETST Name, F4 for list 
VERSION emp xeeben ch Peo ode hops 01 01-99, *HIGHEST 
Report date range: 
Eromidate® “ian) essere vetoes ees 19990101 Date (YYYYMMDD), *AVAIL, ... 
MOndaCo eo ey eer as chee ee tens 19990930 Date (YYYYMMDD), *CURRENT 
Call CM for iSeries program ..  ¥*YES *YES, *NO 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 309. Add to CM for OnDemand Panel 
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The Add to CM for OnDemand (ADDVIRDAR) command allows you to add 
existing OnDemand report indexes into Content Manager as external references. 
You can select the OnDemand reports that you want to integrate by specifying a 
range of report dates. 


Specify if you want to call Content Manager program QVIXRFINX to complete the 
addition of the external references into Content Manager. You can retrieve and 
view the OnDemand reports by the Content Manager workstation Client provided 
you call the QVIXRFINX program and add the new external references to Content 
Manager. 


In order to automate the integration of future OnDemand reports and the removal 
of expired or deleted reports, remember to add the appropriate index exit to the 
appropriate OnDemand report definition for any reports integrated using 
ADDVIRDAR. 


Remove from Content Manager for OnDemand (RMVVIRDAR) 


command 
( 
Remove from CM for OnDemand (RMVVIRDAR) 
Type choices, press Enter. 
Report: name: “ess ce, foes es tos ws fe INVOICETST Name, F4 for list 
VERSION Gee deve sete Meee ogra tatters 01 01-99 
Report datet rc. cmt eted aaler cs 19990615 Date (YYYYMMDD) 
Report sequence number. .... 001 001-999, AAA-999 
Call CM for iSeries program . . *YES *YES, *NO 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 310. Remove from CM for OnDemand Panel 


The Remove from Content Manager for OnDemand (RMVVIRDAR) command 
allows you to mark Content Manager external references to an OnDemand report 
for deletion. This does not delete the report from OnDemand. 


Specify if you want to call Content Manager program QVIXRFDEL to complete the 
removal of the external references from Content Manager. You can no longer 
retrieve and view the OnDemand reports by the Content Manager workstation 
Client after you call the QVIXRFDEL program and remove the external references 
from Content Manager. 
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Work with Admin for OnDemand (WRKADMRDAR) command 


(e : , > 
Work with Admin for OnDemand (WRKADMRDAR) 


Type choices, press Enter. 


Administrator function. .... > *RPTEXT *REPORT, *RPTEXT, *RPTGRP... 
Report extension name ..... *ALL Name, generic*, *ALL... 


Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 


Figure 311. Work with Admin for OnDemand 


The Work with Admin for OnDemand (WRKADMRDAR) command with 
TYPE(*RPTEXT) allows you to create, change, copy, delete, or display OnDemand - 
Content Manager report definition extensions. The extensions contain information 
regarding the relationship between OnDemand report segments and Content 


Manager, such as the correspondence between OnDemand keys and the Content 
Manager keys.|Figure 312 on page 270|shows a sample screen to work with *ALL 


report extensions. 


Note: Users of the WRKADMRDAR command with the TYPE(*RPTEXT) 
parameter must be: 


* Valid Content Manager users. 
* OnDemand administrators. 


* Authorized to all necessary Content Manager index classes. 
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(e > 


6/21/99 Report Definition Extensions for CM for iSeries QSECOFR 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display 


Report Report CM for iSeries 
Opt Name Version Index Class 
1 INVOICETST 01 
—  CHECKSTMTS O01 CHECKSTM 
SUNSEEDS 01 SUNSEEDS 


Bottom 


F3=Exit F5=Refresh F12=Return 


Figure 312. Report Definition Extensions Panel 


If this is a new installation of the OnDemand - Content Manager integration 
support, there will be no existing extension records. 


To add a new report extension: 
1. Type 1 in the Opt column on the first available line. 


2. Enter a Report Name in the report name column on the first available line. For 
example, INVOICETST. 


3. Type in a valid report version such as 01 in the Report Version column on the 
first line that is available and press Enter. 


Va 

6/21/99 Update OnDemand Report Definition Extensions QSECOFR >) 
OnDemand Report Name: INVOICETST 
OnDemand Report Version: 01 
OnDemand Report Description: Test Invoices (OnDemand Sample) 


CM for iSeries Index Class: INVTEST 
CM for iSeries Content Class: 0303 


F3=Exit F5=Refresh F12=Return 


Figure 313. Create Report Definition Extensions Panel 2 
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If the OnDemand report definition exists, its description displays. If not, the 
description will be blank. 


Enter the Content Manager index class that you would like to relate to this 
OnDemand report/version and press Enter. 


The above example uses the INVTEST index class. 


6/21/99 Update OnDemand Report Definition Extensions QSECOFR 
OnDemand Report Name: INVOICETST 

OnDemand Report Version: 01 

OnDemand Report Description: Test Invoices (OnDemand Sample) 

CM for iSeries Index Class: INVTEST Desc.: Invoice Test Report 


CM for iSeries Content Class: 0303 
2nd Level Index Exit: 
2nd Level Exit Lib: 


Specify 
OnDemand Key Fields Key Relationships CM for iSeries Key Fields 


6 Report Date Report Date 


1 Invoice No. ie S 1 1 Invoice Number 
2 Customer No. = = 2 2 Customer Number 
3 Salesman Ss = 3 3 Salesman 
4 Invoice Total = a 4 4 Invoice Total 
5 Order# = 5 5 Order Number 

= 6 6 

a 7 i 

il 8 8 


F3=Exit  F12=Return 


Figure 314. Create Report Definition Extensions Panel 3 


If the OnDemand report definition exists, the OnDemand key field descriptions 
display. 


If the Content Manager index class exists, the index class description and key field 
descriptions display. 


Note: If the user running the WRKADMRDAR command with TYPE(*RPTEXT) is 
not a valid Content Manager user, the index class description and key 
descriptions will be blank. 


The fields and their meanings are as follows: 


OnDemand Report Name 


Used to identify the report to be integrated. It can be up to 10 characters in 
length, and must not contain any * or # special characters. The name 
entered here must match exactly the name in the OnDemand Report 
Definition. This is a mandatory entry field during the update or create 
process. 


OnDemand Report Version 


Report Version allows OnDemand to keep track of multiple iterations of 
the same report. The version entered here must match exactly the version 
in the OnDemand Report Definition. This value must be in a range from 01 
to 99. This is a mandatory entry field during the update or create process. 


OnDemand Report Description 
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The description of the OnDemand Report Definition. 
CM for iSeries Index Class 


This field defines the Content Manager Index Class that is associated with 
the integrated OnDemand document (segment). Define the Index Class to 
Content Manager before running the OnDemand batch capture and 
integration for Content Manager. This is a mandatory entry field during 
the update or create process. 


CM for iSeries Index Class Desc 
The Content Manager index class description. 


CM for iSeries Content Class 
The Content Manager (CM) Content Class that will be used when Content 
Manager retrieves this OnDemand report. See the Content Manager 
EKD0318 file for valid content classes that can be entered. 


Second Level Exit Program 


IBM provided this user exit to allow you to perform additional functions 
during the OnDemand - Content Manager integration process. A later 
section of this publication provides more detail. This is an optional entry 
field during the update or create process. 


Second Level Exit Library 


This field names the library that contains the user exit program described 
in the previous field. 


Key Relationship Fields 


OnDemand supports five searchable keys and the ability to do report date 
range searches. 


Content Manager supports up to eight searchable keys. 


Mapping the OnDemand key values into Content Manager requires a 
method of mapping the key values. 


These fields map the values of OnDemand report keys to Content Manager 
keys. These fields can have a value from 1 - 6. The Report Date for all 
OnDemand reports is key 6. To specify a key relationship enter the 
OnDemand key number in the line in front of the corresponding Content 
Manager key. 


Specification of any of these values will result in the corresponding 
OnDemand keys being substituted into the Content Manager document 
keys. You must specify at least one key during the update or create 
process. 


Loading Content Manager External Reference Indexes 
(QVIXRFINX) 


The Content Manager Index loading program is a high speed batch interface which 
loads external reference information into Content Manager. 


The QVIXRFINX program has no parameters, and you can run it repeatedly. As 
OnDemand adds each external reference to Content Manager, Content Manager 
assigns each external reference with an item id and an object id. Content Manager 
updates the external reference interface file with object ids for each processed 
external reference. When you call the QVIXRFINX program again, it processes only 
unprocessed records. 
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A sample call statement follows below: 
CALL PGM(QVI/QVIXRFINX) 


You will find the QVIXRFINX program in the QVI library. 


Deleting Content Manager External Reference Indexes 
(QVIXRFDEL) 


The Content Manager Index deletion program is a batch process which deletes 
external reference information from Content Manager. The system deletes the 
external reference even if you re-index it in Content Manager or put on a workflow 
process. It will also delete all Content Manager annotations and notes for the 
external reference. 


The QVIXRFDEL program has no parameters and you can run it repeatedly. 
Content Manager deletes only external references that are marked for deletion. 


A sample call statement follows below: 
CALL PGM(QVI/OVIXREDEL) 


You will find the QVIXRFDEL program in the QVI library. 


Index Exit (QRLWEXITV) 


The QRLWEXITV index exit program is called when either of the OnDemand 
commands STRCDSRDAR or STRMONRDAR are issued (assuming the program 
has been specified in the index exit field in the OnDemand report definition). The 
exit program uses the OnDemand report definition extension file to determine how 
to map key values from an OnDemand report to a corresponding Content Manager 
index class. The QRLWEXITV program adds external data reference records to the 
Content Manager interface file (EKD0314). 


Index Exit (QQRLWEXITVM) — Multi-key 


The QRLWEXITVM index exit program is called when either of the OnDemand 
commands STRCDSRDAR or STRMONRDAR are issued (assuming the program 
has been specified in the index exit field of the OnDemand report definition) and 
also when the QRLWINZV program is called. The exit program uses the 
OnDemand report definition extension file to determine how to map key values 
from an OnDemand report to a corresponding Content Manager index class. The 
QRLWEXITV program adds external data reference records to the Content 
Manager interface file (EKD0314). 


You must use the QRLWEXITVM index exit when any of the OnDemand report 
keys or display fields are Multi-key fields. 


Using this multi-key index exit for Content Manager integration may produce 
unexpected results if your multi-key key values do not repeat on every indexed 
line of your report. For example, assume key 3 is Department Number and key 4 is 
Employee Name. If Department Number only prints beside the first Employee 
Name on the page, but is not reprinted beside each subsequent Employee Name 
on the page, then this exit program will only associate the Department Number 
with the first Employee Name. The subsequent Employee Names will have a blank 
Department Number associated with them. For reports of this type, you can use 
the ADDVIRDAR and RMVVIRDAR commands to integrate and delete them, or 
modify the original report to add a repeating Department Number value on the 
printed page. 
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Index Exits - Additional Information 


* If you require an index exit for reasons in addition to Content Manager 
integration, you can create your own index user exit program (as described in 


1 Spool File Archive User Exits and Application 
[Programming Interfaces” on page 291). Then call the QRLWEXITV or 
QRLWEXITVM program from your program, passing the same parameter 
structure. Name your program QRLWExxxxx, where xxxxx can be any 
meaningful characters. The new program name becomes the name you enter in 
the OnDemand report definition in the index exit field. 


* By using the user exit naming convention of QRLWExxxxx, you are identifying 
which OnDemand reports are integrated with Content Manager. By doing this, 
you automatically enable OnDemand to remove reports from Content Manager 
whenever the reports are deleted or expired from OnDemand. 


Second-Level Index Exit 


To expand on the level of application integration between OnDemand and Content 
Manager, the OnDemand Report Definition Extension file supports the 
specification of a second level index exit. You can write this user exit program to 
perform additional functions than those that are provided in the standard software. 
The exit receives all parameters that contain the OnDemand keys so that a 
customer database can be populated, additional Content Manager APIs issued, and 
so forth. 


Parameters 


Required Parameter Group: 


1 OnDemand Report Name_| Input Char(10) 

2 OnDemand Report Version | Input Char(2) 

3 OnDemand Report Date Input Packed(8,0) 
(YYYYMMDD format) 

4 OnDemand Report Input Char(3) 
Sequence Number 

5 OnDemand Report Input Packed(11,0) 
Segment Displacement 

6 OnDemand Key 1 value Input Char(25) 

7 OnDemand Key 2 value Input Char(20) 

8 OnDemand Key 3 value Input Char(20) 

9 OnDemand Key 4 value Input Char(20) 

10 OnDemand Key 5 value Input Char(15) 

11 Content Manager Index Input Char(8) 
Class 

12 Content Manager Content | Input Char(4) 
Class 

13 Reserved Input Char(50) 


As a general rule, you can write a different second level exit for each different 
OnDemand report which requires it, with knowledge of the specific environment. 
Each report can have a unique second level index exit (if needed) by naming it in 
the Report Definition Extension. 
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The programmer is free to use all Content Manager APIs in the second level exit 
except any that are specifically for interactive use. At the time of the second level 
exit call, all Content Manager interface file updates have been completed for the 
document. The programmer should code the second level exit to properly manage 
customer files, and so forth. The index exit programs (QRLWEXITV and 
QRLWEXITVM) started by the STRCDSRDAR and STRMONRDAR commands call 
the second level exit. 


The second level exit integration does not automatically close the second level 
index files on behalf of the programmer. 


For ILE programs, compile second-level exit programs with activation group set to 
*CALLER. 


Problem Determination 


Content Manager Client messages 
FRN6556A: The system cannot get the object. 


This is a somewhat generic message that is displayed when the Content Manager 
Client cannot display an OnDemand segment. There are several possible causes for 
this message: 

1. The user is not an authorized OnDemand user. 

2. The user has no authority to the OnDemand report. 

3. The user has no authority to the specific report segment (key security). 

4 


. The report segment no longer exists in OnDemand because the report is 
expired or deleted. 


5. The OnDemand report indexes for this report have been migrated to tape or 
optical. 

6. The report segment is on optical storage, but the platter is not in the optical 
library. 

7. The report segment is on tape. The system automatically submits a request to 
batch to recall the report, but until the system recalls the report, the users will 
receive this message. 


OS/400 messages 


MCH0802: Total parameters passed does not match number required. Program 
QRLRCDS attempted to call program QRLWEXITV with too many parameters. 


This message will appear when archiving a report by using the QRLWEXITV index 
exit for a report with at least one key value with Multi-key being set to yes. (In 
that case, use QRLWEXITVM instead.) A similar message will appear if your report 
definition uses QRLWEXITVM but your report has no Multi-key keys. A similar 
message can also appear if you used the correct Index Exit but placed it in the 
INPUT EXIT field in the report definition by mistake. 


Recovery: When archiving a Multi-key report, use the QRLWEXITVM index exit 
instead of the QRLWEXITV index exit. 


LNR7200: Message ’MCH3402’ in program object 'QRLWADMV’ in library 
“QRDARS’ (C D F G). 
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This message will appear when attempting to work with OnDemand report 
definition extensions if either the Content Manager data library or program library 
have not been added to the library list of the job. 


Recovery: Use the add library list entry (ADDLIBLE) command to add the missing 
Content Manager data or program library to the library list. The Content Manager 
data library must appear before the program library in the library list. 


LNR7204: Message ’CEE9901’ in called program ’OVIAPI’ (C D F G). 


This message will appear when attempting to work with OnDemand report 
definition extensions if neither of the Content Manager data and program libraries 
have been added to the library list of the job. 


Recovery: Use the add library list entry (ADDLIBLE) command to add the Content 
Manager data and program libraries to the library list. The Content Manager data 
library must appear before the program library in the library list. 
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Chapter 8. For the OnDemand Spool File Archive End User 


Before you start to use OnDemand, IBM recommends reading Chapter 3 of IBM 
Content Manager OnDemand for iSeries Installation Guide, which explains the 
available features of OnDemand. That chapter provides the following information: 


* It describes the appearance of the screens. 
* It tells you how to obtain help when you need it (with screens or fields) 


* It defines some terms that might be new to you. 


If your responsibilities include retrieving archived reports to view, to print, to send 
facsimiles, or work with annotations, this chapter shows you how. First, you enter 
the name of the report or report group you want to find. Then, you can search for 
more information within the report or group and, finally, print the information or 
send a facsimile. 


Getting Started 


Your system administrator has given you security access to OnDemand. Generally, 
you will be working from the Sreciry Report SEARCH screen. There are three ways to 


display the screen shown in|Figure 315 on page 278 


1. Select a menu option from one of your existing application menus (if one has 
been added by your programmers). Press Enter. 


2. Use a fast-path command to go directly to it from an OS/400 command line. 
Type FNDRPTRDAR on the OS/400 command line. Press Enter. (The ability to 
enter a command on the command line may not be available to you.) 


3. Select option 1 from the OnDemand Main Menu. Press Enter. (As an end user, 
you probably will not access OnDemand reports this way.) 


Figure 315 on page 278] appears. 


Retrieve Reports 


Use this screen to begin retrieving reports or groups of reports. (Press F1 for HELP 
if you need more information.) 
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fe 
Specify Report Search 
000 DDDD 
0 O D OD 
O ONNNN D D EEE MMM MM AAAA N 
0 ON ND DE EM MMA AN 
0 ON ND DEEEEEM MMA AN 
O.OUN INGDS Due MM MA AN 
000 N N DDDD EEE M M M AAAA N 
Type choices, press Enter. 
REPOVCS ese ve, eten hog sense rece is CHECKSTMTS 
-OR- 
Report group: 2. 6 6s, es, 
Date range 
RIAOIIY Mreeramren He eevee so ace ther YYYYMMDD 
Nl. co Soha st aie nwo ro. ae YYYYMMDD 
F3=Exit F4=Prompt  F12=Cancel 


1/04/98 


D 

D 
DDDD 
ND OD 
ND OD 
ND 
N DDDD 


Name, generic*, F4 for list 


Name, genericx, F4 for list 


ONDMD400 
14:27:53 


Figure 315. Specify Report Search 


If you entered a particular report name or report group name, press Enter to move 
to [Figure 318 on page 279 


s Select Report ONDMD400 *) 
1/04/98 14:31:11 
Type option, press Enter. 
1=Select 

Option Report Text 
AGEDOC Age Open DOC 
AGEOPN Aged open receivable report 
AIC250 Warehouse report 
ANNOUNCE Announcement list 
APCHK A/P checks 
AP437 A/P account listing 
BEL3549 Bank edit 
BRMS50 Tape processing rpt 
BUDGET Budget report 
CHECKSTMTS Check statements 
GLDAILY G/L Daily by account 
GLTRANS G/L Transaction report 

More... 
F3=Exit F12=Cancel 
2, 


Figure 316. Select Report 


This screen shows you a list of reports and their descriptions. A report name 
appears on this screen only if there is at least one archived report of that name 


available for retrieval. 


Press Enter to move to|Figure 318 on page 279 
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Select Report Group ONDMD400 
1/04/98 14:32:05 
Type option, press Enter. 
1=Select 


Option Report group Text 


ACCTG Reports for Accounting 
INVENT Inventory Reports 

INVINFO Invoice-related reports 

IS Information Systems Reports 


More... 
F3=Exit  F12=Cancel 
e/ 
Figure 317. Select Report Group. 
This screen shows you a list of report groups and their descriptions. A report 
group appears on this screen only if there is at least one archived report in that 
group available for retrieval. 
Press Enter to move to |Figure 318 
A >) 
Select Report Result ONDMD400 
1/04/98 14:29:08 
Type option, press Enter. 
1=Select 
Sequence 
Opt Report Report date number Location Text 
1 CHECKSTMTS 1995/06/01 001 DISK Check Statements 
CHECKSTMTS 1995/05/01 001 DISK Check Statements 
CHECKSTMTS 1995/04/01 001 OPTICAL Check Statements 
CHECKSTMTS 1995/03/01 001 OPTICAL Check Statements 
CHECKSTMTS 1995/02/01 001 OPTICAL Check Statements 
CHECKSTMTS 1995/01/01 001 OPTICAL Check Statements 
CHECKSTMTS 1994/12/01 001 OPTICAL Check Statements 
CHECKSTMTS 1994/11/01 001 OPTICAL Check Statements 
CHECKSTMTS 1994/10/01 001 OPTICAL Check Statements 
More... 
F3=Exit  F12=Cancel 
yy 


Figure 318. Select Report Result 


This screen displays the search results for all CHECKSTMTS reports. (The example 
does not ask for a CHECKSTMTS report with a particular date.) 


Press Enter to continue to|Figure 319 on page 280 
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Refining Your Search 
This screen displays additional information about CHECKSTMTS. 


( Specify Document Search ONDMD400 ) 
1/04/98 14:40:45 
Report, 2225 eo ees See 3 ICHECKSIMTS 
Report. type. . ast we IDOE 


Type choices, press Enter. 


Key values: Required key length 
1. Account Number. 3 = 9). 
2. SSNi/ Tax=ID s, 3 - 1l. 
3. Cust Name er Ss 125 
Search all report sequence numbers ......... ¥ Y=Yes, 
N=No 
Report sequence number .. 2... 1.6 2 2 ee wae 001 1-999 
Date Range: 
YOM) sige eats Hee eae! cen hee ec vircanseces cee eee en ete ss 19950217 + +YYYYMMDD 
i Kulu dent ctr Senet i HOPES rh cre (aenee eC emt em eee ahtoee 19950217 YYYYMMDD 


F3=Exit F12=Cancel 
SS EE 


Figure 319. Specify Document Search 
If the report is part of a report group, |Figure 320|appears instead. 


Soe 
Specify Document Search ONDMD400 ) 
1/04/98 14:46:55 
Report/Group ....... . : CKSTM / CUSTSERV 
Report. type’< 23. %. 2 a <2. 4 DOC 
Type choices, press Enter. 
Key values: Required key length 
1. Account Number. 3- 9. 
22S SN Maxs TDi te 3 - 1l. 
3. Cust Name .... 3 - 12. 
Search all report sequence numbers ......... Y Y=Yes, 
N=No 
Report sequence number .... 2.45 2c ee eee 001 1-999 
Date Range: 
SCI mca Soeete ch Maer one ate Cathe eure rece React eran 19950217 YYYYMMDD 
(Rom caer oeecearia conch ts ch oe akon aT Coeare ene coe rae 19950217 YYYYMMDD 
F3=Exit F6=Group Search  F12=Cancel y, 


Figure 320. Specify Document Search 


The Key values fields let you use keys (indexes) to limit your search. You can 
enter, for example, an entire account number—for a fully qualified search key—or 
a part of the account number, for a partially qualified search. Your system 
administrator creates these keys when defining the report, and lists them for you. 
Your keys might be different from the ones in the example. 
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You must use at least one of these fields. (Five fields can appear on the screen.) 


In this example, the fields you can view are: 


Report name/Group name 
This is the report name (and report group name, if applicable) you 
selected. 


Report type 
This example shows a DOCument-type report. 


Other types are PAGE or NODX (for NO-INDEX). 


In this example, the fields you use are: 


1. Account Number 
Enter the first complete or partial key. A partial key is comprised of one or 
more alphanumeric characters followed by an asterisk (*). OnDemand will 
consider only the characters to the left of the asterisk when searching the 
index. (Due to the unique nature of the key structure, partial keys are not 
supported for PAGE reports.) 


An example: A partial key search, such as 251*, which searches for all 
checking statements with account numbers that begin with 251. 


You can enter *ALL to show all segments of the report. 


2. SSN / Tax-ID 
Enter the second complete or partial key. 


3. Cust Name 
Enter the third complete or partial key. 


Search all report sequence numbers 
Enter either: 
* Y to search all possible report runs (sequence numbers) for this date. 


* N to search only the sequence number you selected from the SELECT 
Report RESULT screen. 


You can change the field if you want to search more or fewer report runs. 


Report sequence number 
Enter the run of the report, for the date you want to view, beginning with 
001. 


You can change this field to view a different run of the report for this date. 


Report Date Range 
The Start Date and End Date fields are from the DocuMENT SEARCH menu. 


Change these dates to expand your search to include runs from multiple 
dates. 
* F6=Group Search 


This function key appears only if the report you have chosen is part of a report 
group. Press it to search for all reports within that group. 


An informational message appears at the bottom of the screen if you enter data 
that is not valid. 


Press either: 


° Enter to move to|Figure 321 on page 282 
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* F6 to search for all reports in the report group (if your report is in a report 
group). 


If you select a group search, the last column in|Figure 321]is replaced by the 
specific report name in the report group. 


(a ; Ss 
Work with Documents ONDMD400 
Grolipi«.. 3 4 <3 1/04/98 15:03:19 
Report .. . : CHECKSTMTS Check Statements (OnDemand Example) 
Type choices, press Enter. 
5=Display 6=Print 7=Fax A=Annotation 
Opt Date Account Number SSN / Tax-ID Cust Name Ending Balance 
* 19950217 251000022 255-77-4993 KATIE ALLEN $ 0.48 
19950217 251000055 236-55-3387 DIANNE WIEST $ 5,671.46 
19950217 251000261 253-26-8119 JESSICA LANG $ 1,186.05 
19950217 251000287 230-88-4523 FORREST GUMP $ 1,416.33 
19950217 251000352 225-88-9441 GRETA GARBO $ 3,777.69 
19950217 251000394 421-33-1886 MARK MIKEAL $ 1,344.67 
19950217 251000469 409-33-2298 JIM WHITMIRE $ 21,016.47 
19950217 251888888 888-88-8888 ALICE WONDER $ 56.84 
More... 
F3=Exit F12=Cancel 


Figure 321. Work with Documents 


The screen displays a list of the report documents that match your search value, 
with additional information about each document. (Column headings in the 
example might not match yours.) An asterisk (*) beside a document indicates that 
an annotation (note) exists for that document. Report widths greater than the 
screen column width will cause OnDemand to display a second line of column 
headings. The headings appear under the first line and display an additional 
function key (F11=Change View) at the bottom of the screen. This allows you to 
toggle so that you can see all the data. If your display supports 132-column wide 
viewing, OnDemand will automatically present the information on a wide screen. 
As a result, you do not even need to press F11! 


For certain report types you will see column headings for Page number or 
Segment number. If the column widths are not sufficient to display all significant 
digits of these values, you will see plus signs (+++++++) in place of the data. If 
this occurs, see your OnDemand system administrator, who can change the report 
definition to specify a longer key name. This will force the column to be wide 
enough to display the values. 


To view a document: 


Opt Type 5 to display a document. Type 5 in front of multiple documents if 
you would like to view multiple documents one after another (pressing 
Enter or F3 or F12 between each one). If your screen shows 5=Combined 
Display instead of 5=Display, then your user profile has been set up to view 
multiple items at one time. In this case, type 5 in front of multiple 
documents if you would like OnDemand to combine them into one 
document for viewing. 
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OR 


Opt 


OR 


Opt 


OR 


Opt 


Press Enter to move to|Figure 322 on page 284 


Type 6 to print a document. Type 6 in front of multiple documents if you 
would like to print multiple documents one after another (pressing Enter 
between each one). If your screen shows 6=Combined Print instead of 
6=Print, then your user profile has been set up to print multiple items at 
one time. In this case, type 6 in front of multiple documents if you would 
like OnDemand to combine them into one document for printing. 


Press Enter to move to |Figure 323 on page 285 


Type 7 to send a facsimile of the document. Type 7 in front of multiple 
documents if you would like to fax multiple documents one after another 
(pressing Enter between each one). If your screen shows 7=Combined Fax 
instead of 7=Fax, then your user profile has been set up to fax multiple 
items at one time. In this case, type 7 in front of multiple documents if you 
would like OnDemand to combine them into one document for faxing. 


Press Enter to move to |Figure 323 on page 285 


Type A to view or add annotations (notes) for the document. Type A in 
front of multiple documents if you would like to work with annotations 
for multiple documents one after another. 


Press Enter to move to |Figure 323 on page 285 


To Display a Document 


Use this screen to look at the report. 
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(e > 


Display Spooled File 


Fier iseenicaec se :  CHECKSTMT Page/Line 1/2 

Controll 4 s ee Columns 1 - 78 

elt 8 bie ore ecyacen ereecant: 

Meevoch a ata lord iar stetslelerl entertain olevake reticle oat sro Bale cehe od ocoieieak severe O cnaievsck otehere Tiere tectie: the 
P. 0. BOX 980 


MARION, S.C. 29571 


ACCOUNT NAME: KATIE ALLEN 


25 LABRADOR AVENUE 


MARION S C 29571 
PAGE 1 OF 4 NOVEMBER 20 - DECEMBER 19, 1990 ACCOUNT 
CHECKS EN 
CONTENTS SCN CHECKING SOC.SEC.N 
OF THIS WITH INSTANT CASH RESERVE 


STATEMENT 


FOR INFORMATION ABOUT ACCOUNT ACTIVITY, CALL 423-6722. 
More... 
F3=Exit F12=Cancel F19=Left F2Q=Right F24=More keys 
Overprinting not displayed. 


Figure 322. Display Spooled File 


* To scroll through the document, use: 

PAGEUP, PAGEDOWN, F19 (LEFT), or F20 (RIGHT) 
* To return to the top of the document: 

Type T in the Control field (near top of screen), then press Enter. 
* To move to the bottom of the document: 

Type B in the Control field (near top of screen), then press Enter. 
* To search for a word in the document: 


Type the word in the Find field (near top of screen), then press F16. (Depending 
on how your system is set up, you might need to enter the search characters in 
upper- and lower-case when you search. 


Press F3 to return to the Spsciry Report SEARCH screen,|Figure 315 on page 278 


OR, press the ATTN key to print the document, to send a facsimile, or to work 
with annotations, using |Figure 323 on page 285 

You can also return to the Directory SEARCH Menu to change your search 
criteria—press F12. 


To Print or To Send a Facsimile or To Work with Annotations 


This screen_appears because you pressed the ATTN key on the Display SpooLeD FILE 
screen (Figure 322), If you select_option 6=Print (or 6=Combined Print) directly, 
then you will see the screen in If you select option 7=Fax 
or 7=Combined Fax) directly, then you will see the screen in 

If you select option A=Annotation directly and_ annotations exist for the 
document, then you will see the screen in If annotations do 
not exist for the document, then you will see the screen in 
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Print/Fax Document ONDMD400 
1/04/98 15:05:45 
Pages in document ......: il 


Type choice, press Enter. 

6=Print 7=Fax A=Annotation 
Opt Date Account Number SSN / Tax ID Cust Name Ending Balance 
6 * 19960627 251000022 255-77-4993 KATIE ALLEN $ 0.48 


Bottom 


F3=Exit F12=Cancel 


Figure 323. Print/Fax/Annotate Document 


The fields you use are: 


Pages in document 
This shows the number of pages in this segment (checking statement, in 
our example). This field cannot be modified. 


Opt _ Enter either: 


* 6 to move to |Figure 324 on page 286 
* 7 to move to |Figure 325 on page 286 
* A to move to|Figure 327 on page 287] (if annotations exist) or|Figure 328 


(if annotations do not exist). 


Press Enter. 


To Print a Document 


This screen gives you a choice of print options. 
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fe 
Print Document ONDMD400 ) 
1/04/98 15:09:05 
Pages in document .....: 1 
Type choices, press Enter. 
Printer: name. 2: % «20% « PRTO1 Name 
-OR- 
Output queue 2 ¢ 3 ss ss Name 
eiibVanVecs, ae. ce cen eee, ete *LIBL Name, *LIBL, *CURLIB 
Number of copies ...... JU 1-999 
Page range: 
Starting: page <=. % % . 1 1-99999999999 
Ending page < : «ec *END 1-99999999999, *END 
Use report overlay ..... «NO *YES, *NO 
F3=Exit F12=Cancel 
e/ 


Figure 324, Print Document 


Press Enter to print. 


The information you enter on this screen (such as printer or output queue name) is 
saved for you; when you request your next print, you do not need to enter it 


again. 


To Send a Facsimile 


Use this screen, |Figure 325} to address and send a facsimile. 


ie 


Fax Document 
Pages in document 
Type choices, press Enter. 


Outgoing Fax number 


ONDMD400 


1/04/98 15:13:12 


Cover page 
Title 


*YES, *NO 


Comment line 


Fax mode *NORMAL 


Number of copies 


F3=Exit F12=Cancel 


*NORMAL, *FINE 
1-999 


More... 


eee SS aay 


Figure 325. Fax Document (1 of 2) 
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Press Enter to display |Figure 326 


(a >) 
Fax Document ONDMD400 
1/04/98 15:13:12 
Pages in document .......: 1 
Type choices, press Enter. 
Page range: 
Stantingnpage 1. ic: 0s a 1 1-99999999999 
EMdingipagets 2. 6) veer en anes *END 1-99999999999, *END 
Use report overlay ...... *NO__ *YES, *NO 
Bottom 
F3=Exit F12=Cancel 
e/ 


Figure 326. Fax Document (2 of 2) 


Press Enter to send the facsimile. 


To Work with Annotations 
If annotations exist for the document, you will see the screen shown in|Figure 327; 


Pe 


Report Annotations ONDMD400 
1/04/98 15:13:12 
Report .. . : CHECKSTMTS/01/19960627.001 
Check Statements (OnDemand Example) 
Account Number SSN / Tax ID Cust Name Ending Balance 
251000022 255-77-4993 KATIE ALLEN $ 0.48 


Annotation 1997-11-04 12:00:37 NOBRIEN 
Katie called to say she figured out her earlier questions... 


Annotation 1997-11-03 14:47:40 NOBRIEN 
Katie called today with general questions about account. 


F3=Exit F6=Add annotation F12=Cancel 


oN 


Figure 327. Report Annotations (if annotations exist) 


Press F3 to exit from the annotation screen. 
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If annotations do not exist or if you press F6é to add annotations from|Figure 327 on 
you will see the screen shown in|Figure 328 


(— ; = 
Report Annotations ONDMD400 


1/04/98 15:13:12 


Report .. . : CHECKSTMTS/01/19960627.001 

Check Statements (OnDemand Example) 
Account Number SSN / Tax ID Cust Name Ending Balance 
251000022 255-77-4993 KATIE ALLEN $ 0.48 


Annotation available to public........ if Y=Yes, N=No 
Type annotation text, then press Enter to add. 


More... 
F3=Exit F12=Cancel 
2 
Figure 328. Report Annotations (if adding annotations) 
Press Enter to add your annotation, then press F6 to confirm the addition of the 
annotation. Press F3 to exit from the annotation screen. 
Changing Your Search Criteria 
You can use this screen, |Figure 329} to change some of your search criteria. 
r 
Specify Document Search ONDMD400 - 
1/04/98 14:40:45 
REPORE? (3.4 tee ee eee ees A CHECKSTMIS 
Report itype22 2 se Be ee ee DOC 
Type choices, press Enter. 
Key values: Required key length 
1. Account Number . 161079652 3 = 9) 
2. SSN / Tax=10' = 4.4 Seo ih: 
3. Cust Name eee 3 - 12. 
Search all report sequence numbers .......... Y Y=Yes, 
N=No 
Report sequence number . 2... 1. es ee eee ww 001 1-999 
Date Range: 
RGOMy Vesey eee ae eee ge oe eens ee oer ee erie Sees eas 19900101 | YYYYMMDD 
Uti herh cca mere tees Riders haere alee eee ete NS cree eer ert ane YYYYMMDD 
F3=Exit F6=Group search  F12=Cancel B 


Figure 329. Specify Document Search 
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You can change the information on this screen to search for documents with a 
different account number, within a specified date range. 
Our examples are: 


1. Account Number 
161079652 


From 19900101 
To You can enter today’s date, or leave the field blank. 


When you press Enter,|Figure 330} can appear immediately if only one document 


meets the search criteria. (If more than one report is found, an intermediate screen 
displays them.) 


Va 
Display Spooled File 
Falies: = sae. e+ ICHECKSIMTS Page/Line 1/2 
Control 3 s5.c Columns 1 - 78 
FANG ss ep cee ores se 
P. 0. BOX 980 


MARION, S.C. 29571 


JOHN DOE 
SPECIAL ACCOUNT 
15 OAK STREET 


MARION S C 29571 
PAGE 1 OF 1 NOVEMBER 20 - DECEMBER 19, 1990 ACCOUNT 
CHECKS E 
CONTENTS SCN CHECKING SOC.SEC. 
OF THIS 
STATEMENT 
More... 


F3=Exit F12=Cancel F19=Left F20=Right F24=More keys 


Figure 330. Display Spooled File 


Press F3 three times to return to the ONDEMAND Speciry Report SEARCH screen, 


Figure 315 on page 278, to continue retrieving reports. 


To Exit OnDemand 


Press F3 from the Report SELECTION screen. You might also need to type SIGNOFF 
at the OS/400 command line to exit from OS/400 completely. 
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Appendix A. OnDemand Spool File Archive User Exits and 
Application Programming Interfaces 


This appendix describes the Spool File Archive user exit programs and application 
programming interfaces (APIs) that OnDemand provides to help you customize 
your environment. 


OnDemand includes sample program source code for a wide variety of functions. 
These functions include Input, Index, Monitor Output Queue, and Unbundle user 
exit programs, as well as others. The name of the sample source file is 
QSAMPLES. A copy of this source file is shipped in library QRDARS and in 
library QUSRRDARS. It is possible to update the file in QRDARS by PTFs with 
new or changed source code; the file in QUSRRDARS does not change. This is by 
design. IBM recommends that you copy the QRDARS members to use as your 
examples. You may place your customized programs in QUSRRDARS if you like, 
or in your own application libraries. You will always have a set of unmodified 
samples that will work as designed, provided you do this. 


Basic User Exits 


A number of user exits are provided as described below. 


Input Exit 


This optional Input exit, valid only for Report data type of “OTHER (as specified in 
the report definition), gives your own program control of spooled file data 
(non-AFP) before the report capture program sees it. If you specify a program 
name in the Input exit field of the Report Definition, the report capture process 
calls that exit program to read the input file. 


The Input exit can use the spooled data to, for example, change values or run 
cross-checks of other line-of-business files. The exit processes a page of data at a 
time; that is, it reads enough print lines to format a page in a page buffer, then 
passes that buffer to the report capture program. 


Fields that are exchanged when the report capture program calls the Input exit are: 
* Page Buffer - 256 bytes x 256 lines 


The exit program places one page of print lines into this page buffer. The buffer 
can have up to 256 lines, with up to 256 characters per print line. The print line 
consists of 255 characters of data plus the carriage control character in column 
one. The user exit program typically changes the data in this page buffer . 


* Line Count - 4 bytes (binary) 


This field holds the actual number of print lines that are in the page buffer when 
the exit returns the buffer to the report capture program. The value for this field 
can vary. This field does not usually change. 


* Record Status - 3 bytes 
The status can be either: 
EOF, when the last page is encountered. 
ERR, if there is an error during normal processing. 


This field should not be modified. 
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After the Input exit builds a page in the page buffer and returns that page to the 
report capture program, the capture program moves that page to its own page 
buffer. It then continues normal processing, such as segmentation, index extraction, 
compression, and OnDemand control file updates. 


There is an example input user exit program in the QSAMPLES source file in the 
QRDARS library. 


Index Exit (for reports with no multi-key fields) 


After the report capture program extracts the key (index) values for a segment of 
the report, it can call the optional Index exit named in the Report Definition and 
pass the key values for the Keys and Display Fields. The Index exit can then, for 
example, replace a key value with information from a line-of-business master file, 
or it can remove blanks or other special characters from a value. 


Index exits are valid only for Report type of DOC (as specified in the Report 
Definition). 


The data (formatted in one data structure as shown in the sample program) 
exchanged between the report capture program and this optional Index exit when 
none of the keys or display fields are defined as multi-key are: 


* Reserved - 8 bytes 
This data should not be modified. 


Typically, one or more of the following keys (which may actually be defined as a 
display field in your Report Definition) are modified by this user exit program. 


* Key 1 - 25 bytes 
* Key 2 - 20 bytes 
* Key 3 - 20 bytes 
* Key 4 - 20 bytes 
* Key 5 - 15 bytes 
* Reserved - 27 bytes 
This data should not be modified. 


When the Index exit returns control to the report capture program, the capture 
program updates the OnDemand index file with the values received from the exit 
program. 


There is an example index user exit program for reports without multi-key keys or 
display fields in the QSAMPLES source file in the QRDARS library. 


Index Exit (for reports with multi-key field(s)) 


This exit program provides function similar to the one described for use with 
reports without any multi-key keys or display fields, but the fields passed to and 


from the exit are different (in order to handle the multi-key environment). Review 
the information in |“Index Exit (for reports with no multi-key fields)”|section, and 


then refer to this section for the data fields passed between the programs. 


The data (formatted in four separate data structures as shown in the sample 
program) exchanged between the report capture program and this optional Index 
exit when any one or more of the keys or display fields is defined as multi-key are: 


* Reserved - 29 bytes 
This data should not be modified. 
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Typically, one or more of the following keys (which may actually be defined as a 
display field) is modified by this user exit program. There are 999 occurrences of 
these key fields passed in an array for the multi-key index records. 


* Key 1 - 25 bytes 
* Key 2 - 20 bytes 
* Key 3 - 20 bytes 
* Key 4 - 20 bytes 
* Key 5 - 15 bytes 


When the Index exit returns control to the report capture program, the capture 
program updates the OnDemand index file with the values received from the exit 
program. 


There is an example index user exit program for reports with multi-key 
keys/display fields in the QSAMPLES source file in the QRDARS library. 


Unbundle Exit 


If you use the report capture process to unbundle spooled files, you can specify an 
optional Unbundle exit in the UBND Report Definition. When the report capture 
program finds a new report in the spooled file, it calls the Unbundle exit and 
exchanges these fields: 


* Report Name - 10 bytes 


This is the report name that the capture program found in the spooled file when 
it found a new report based on the UBND report segmentation criteria. 


This field might be changed in this user exit program. 
* Report Version - 2 bytes 
This is the version number of the Report Definition that is being used for this 
report capture. Valid values are 01 through 99. 
This field normally is not changed, but might be. 
* Print Line - 256 bytes 
This is the print line that holds the report name. The print line consists of 255 
characters of data plus the carriage control character in column one. 
This field typically is not changed by this user exit program. 


The Unbundle exit can change the report name or the report version (or both) that 
is found in the spooled data to any valid report name or version defined to 
OnDemand. 


There is an example unbundle user exit program in the QSAMPLES source file in 
the QRDARS library. 


Monitor Output Queue Exit 


The Monitor Output Queue function (for details and screens, see|“Option 5. Start] 
automatically processes spooled files from 
selected output queues. When a spooled file is selected from an output queue to be 
processed, OnDemand first checks for a user exit program in the job’s library list 
with a name that matches the spooled file attribute (*SPLFNAME, *FORMTYPE, 
*USERDATA) that the Monitor was defined to use. If a user exit program is not 


found, OnDemand looks for a report definition that matches the spooled file 
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attribute. If a program is found, it is called, and the report name or version is 
changed by the program as needed. Then OnDemand looks for a report definition 
that matches the new name/Vversion. 


If OnDemand finds a user exit, it calls it and passes several fields, only two of 
which should be changed. These two changeable fields are: 


* Report Name - 10 bytes 
* Version - 2 bytes 


You can design a Monitor Output Queue user exit to alter the report name that the 
Monitor finds as it processes the particular spooled files in the output queue. For 
example, if the monitor finds PGM123 in the User Data spooled file attribute of the 
spooled file, but you want OnDemand to use the report name of INVOICES, you 
can write your user exit program as the example shows: 


IF RPTNAME = ’PGM123’ THEN CHANGE RPTNAME TO ‘INVOICES’ 


There is an example monitor output queue user exit program in the QSAMPLES 
source file in the QRDARS library. 


Monitor Output Queue Date Exit 
The Monitor Output Queue (for details and screens, see 
Output Queue” on page 83) automatically processes spooled files from selected 


output queues. A user exit program by the name of QRLRMEXIT can be created 
to change the report run date (which affects migration and expiration processing) 


and optionally the report posting date (that the end users see) if the report has no 
Posting date defined in the OnDemand report definition. 


The QRLRMEXIT program will be called if it exists in the Monitor job’s library 
list. If OnDemand finds this user exit, it calls it and passes two fields, only one of 
which can be changed. The two fields passed between the Monitor and the user 
exit are: 


* Report Name - 10 bytes 


This is the report name that has been selected by the Monitor, based on the 
Spooled file name, Form type, or User data. It cannot be changed by this 
program. 


* System Date - 6 bytes 


The value passed into this program is the current system date, in either 
YYMMDD or MMDDYY or DDMMYY or YYJUL format (depending on your 
system's setup). This value will be used as the job date when the Monitor stores 
the report. This date can be changed to any valid date. The new date must be in 
the format specified by the system value QDATFMT. (It is assumed that the job 
attribute DATFMT is the same as the system date format.) If the date returned 
from this program is not valid, the current system date will be used as the job 
date for storing the report. 


Consider this example: A year-end summary report of the previous year’s data is 
run sometime during the first week of the new year. Unfortunately, the end users 
want the report date on this report to reflect the year for which the report was run. 
You could use this user exit to test for a certain report name, and if the report 
name passed in to the exit program is the year-end summary report name, then 
change the date in the exit program to be the last date of the previous year. 
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There is an example of a monitor output queue date user exit program (source 
member name QRLRMEXIT) in the QSAMPLES source file in the QRDARS 
library. 


Facsimile Exit 


The Facsimile exit is designed to enable OnDemand to work with facsimile (fax) 
software other than Facsimile Support for iSeries from IBM. 


To accomplish this, modify and recompile the QRLRSFAX program source code to 
change the command that is issued when an end user requests a fax during report 
retrieval. Simply change the line in the program that issues the SNDFAX 
command to use the command for the fax software you have installed on your 
system. (You could also call a program if no command is available.) 


An end user requesting a fax calls the QRLRSFAX program. If you do not change 
and recompile it, the standard program will run (which issues the Facsimile 
Support/400 command). If you do change and recompile it, then the changed 
program will run (which will issue your facsimile command). (Be sure to preserve 
the QRLRSFAX name and place the compiled program back in QRDARS library 
to replace the program that is shipped by IBM). 


The CL source for this program (member name QRLRSFAX) is in the QSAMPLES 
source file in the QRDARS library. IBM recommends that you copy this source 
code into a backup member in case you need to go back to the original function as 
shipped from IBM. When you recompile your program, remember to keep the 
name ORLRSFAX so that OnDemand will find it and call it at the appropriate 
time. 


Advanced User Exit 


OnDemand Viewer Exit 


This section describes the OnDemand Viewer Exit which allows you to replace the 
OnDemand 5250 viewing program with one of your own. 


The exit has a required fixed number of parameters to pass. The return code 
parameter controls the errors. 


Viewer Exit 


Parameters 


Required Parameter Group: 


1| Exit format name Input Char(8) 

2| View action Input Char(10) 
3 | Maximum spool record Input Binary(4) 

length 

4| Spool record length Input Binary(4) 
5| Report data type Input Char(10) 
6 | Printer file Input Char(20) 
7 | Action to take Input Char(1) 

8 | Object class Input Binary(4) 
9) Length of data in buffer Input Binary(4) 
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10 | Data buffer Input Char(*) 

11 | Report ID Input Binary(4) 
12 | SEGD0100 Input Char(159) 
13 | Return code Output Char(10) 


Threadsafe: No. 


The Viewer Exit provides a method to use an alternate viewer with OnDemand 
stored data. When enabled, it calls this exit whenever a user selects a segment for 
viewing, printing, or faxing from the Work with Documents’ 5250 screen. 


To determine if a viewer exit should be used for a report, use the following 
sequence to determine whether and what to call an exit. 


1. Check report definition. If exit name specified here, use it. 


2. Check the OnDemand user defaults. If it contains an exit name, use that as the 
exit. If "NONE, no exit is to be used, if none of the previous was true, check 
the OnDemand global defaults. 


3. Check the OnDemand global defaults. If it contains an exit name, use that exit. 
If no exit name exists, then use no exit name. 


Specifying an exit in the report definition makes it a specific report exit; one that 
only has to handle that specific report. If the exit is from the user/global defaults, 
it is said to be a general report exit. This exit must be able to handle data from 
potentially many different reports. 


The exit must be able to handle all types of data potentially called. Currently this 
can be *OTHER line data, *AFPDS data, *AFPDSLINE data, *SCS data, or any of 
the AnyStore data types. For example, when the data that is in the data buffer is 
*OTHER line data, the data has an ANSI first character forms control character in 
the first column. The print data is in the remaining columns up to the spool record 
length. These records will be one after another in the buffer. If the data is *AFPDS, 
then the data in the data buffer will be AFP structured fields. These fields have a 
self-defining record length and are placed one after another in the buffer. If an exit 
can not handle the type of data presented, there is a way through the return code 
to direct OnDemand to handle the request. Do this by using the special return 
code value of *NOACTION. 


The exit must be able to handle all allowed actions to take since using an exit 
overrides the normal OnDemand handling of those requests. These action are view, 
print, and fax. To allow a combined view, the exit must be able to deal with any 
view action allowed. By not allowing a combined view, the only view action 
presented is *ONLY. 


Notes 

1. General exits (ones that are specified at the user or global level) do not have to 
handle all types of data. They may use the "*NOACTION" return code to have 
the normal view path taken. 

2. When doing a combined or multiple view, any part requiring an exit requires 
the exit to handle any of the combinable data. 

3. AnyStore items must have a report exit if they are to show up on the 5250 
report selection hit list. 

4. AnyStore items must have a report exit if you want to retrieve an AnyStore 
segment from the 5250 interface. 
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Authorities and Locks 


The user profile QRDARS400 must have these authorities to the exit program. 


Library Authority 
*EXECUTE 


Program Authority 
*EXECUTE 


Data Area Authority 
*USE 
Required Parameter Group 


Exit format name 
INPUT; CHAR(8) 


VEXT0100 
Viewer Exit format 100 


View action 
INPUT; CHAR(10) 


The valid fields are: 
*ADD Subsequent segment of a multiple segment view. 
*CLEAR 


Clear the data that is accumulated in a multiple segment view. 
*NEW First segment of a multiple segment view. 
*ONLY 

This is the only segment, process and display the data. 
*VIEW 

Display the data from the multiple segment view. 


Maximum spool record length 
INPUT; BINARY(4) 


For a multiple segment view, this is the maximum receivable record length. It 


will be 0 if the segments contain AFPDS data. 


Spool record length 
INPUT; BINARY(4) 


Record length of the spooled data in this segment. The data buffer contains "n" 


number of these records. 


Report data type 
INPUT; CHAR(10) 


Type of data in the data buffer. Valid values for this field are: 


*AFPDS 
AFPDS data 


*AFPDSLINE 
Mixed line data and AFPDS data 


*BUFFER 
AnyStore *BUFFER data 


*FILE 
AnyStore *FILE data 
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*IFS 
AnyStore *IFS data 


*LINE 
Line data with *FCFC 


*OTHER 
Line data with *FCFC 


*SCS 
SCS data 


*SPLF 
AnyStore *SPLF data 


Note: For any of the AnyStore values in the list, no data is provided in the 
buffer. You must use the appropriate AnyStore API to retrieve it. 


Printer file 
INPUT; CHAR(20) 


The name of the printer file that you want to use. The first 10 characters 
contain the file name, and the second 10 characters contain the library name. 
The library name can contain these special values. 


*CURLIB 
The job’s current library 


*LIBL The library list 


Action to take 
INPUT; CHAR(1) 


Performing the action that the user requested. 


5 View 
6 Print 
7 Fax 


Object Class 
INPUT; BINARY(4) 


For AnyStore objects, this is the object class of the object. 
No object class specified 

Bitmap type object 

GIF type object 

PCX type object. 

PDF type object 

PostScript type object 


Aa ua FF W NY - OC 


TIFF type object 
7 JPEG type object 


Length of data in buffer 
INPUT; BINARY(4) 


Length of the data returned in the data buffer. 
Data buffer 
INPUT; CHAR(*) 
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Buffer that contains the segment data. This buffer can be up to 2 million bytes. 
The Report data type defines the format of the data. The spool record length 
specifies any existing record length. For AFPDS data, the buffer will contain a 
stream of "5A” structured fields that have an embedded length. For an 
AnyStore, item no data will be in the buffer. Use the appropriate AnyStore API 
to retrieve the segment. 


Report ID 
INPUT, BINARY(4) 


The numeric id of the report the system is processing. If multiple segments are 
being combined, this value may be not be valid. 


SEGD0100 
INPUT; CHAR(159) 


Information about the segment. See |“Retrieve Segments Format” on page 182 


for a description of this data. 


Return code 
OUTPUT; CHAR(10) 


Value provided back from the exit program to indicate what happened in the 
exit. There exist two special values for the return code. 


*GOOD 
Exit program handled the data with no error 


*NOACTION 
The exit program took no action. When this happens, OnDemand takes 
the normal view route whenever possible. 


Any other value will be interpreted that the exit had an error and that the 
value passed back reflects something about the error. The system displays this 
value to the user and then logs it into the job log. It is suggested that the exit 
log any errors it encounters into the job log. 


SEGD0100 Format 


This format defines the input segment information. 


Offset 

Dec Hex Type Field 

0 0 CHAR(10) Report Name 

10 A CHAR(2) Version 

12 Cc PACKED (11 0) Compressed length 
18 12 PACKED (11 0) Full length 

24 18 PACKED (11 0) Displacement 

30 1E CHAR(25) Key 1 

55 37 CHAR(20) Key 2 

75 4B CHAR(20) Key 3 

95 5F CHAR(20) Key 4 

115 73 CHAR(15) Key 5 

130 82 CHAR(8) Date 

138 8A CHAR(1) Period 

139 8B CHAR(3) Sequence number 
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Offset 
Dec Hex Type Field 
142 8E CHAR(1) Annotations flag 
143 8F CHAR(16) Segment handle 


Field Descriptions: 


Annotations flag 
Valid values for this field are: 


Y Notes exist for this segment. 
N_ No notes exist for this segment. 


Compressed length 
Size of the segment after it is compressed. 


Date 
Date of the segment in the format of YYYYMMDD. 


Displacement 
Offset from the beginning of the object to this segment. 


Full length 
This field contains either the uncompressed length of the segment or the 
resource group id (negative number). 
Key 1 
Value of key1. 
Key 2 
Value of key2. 
Key 3 
Value of key3. 
Key 4 
Value of key4. 
Key 5 
Value of key5. 


Period 
Always contains a period. 


Report name 
Name of report. 


Segment handle 
Access handle for this segment. 


Sequence number 
Sequence number of archived object. 


Version 
Report version. 


Basic APIs 
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For a quick and easy addition to your own applications, review the APIs in this 
section. 
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FNDRPTRDAR Application Programming Interface 


You can use the FNDRPTRDAR application programming interface when you 
want to add OnDemand report retrieval to a user menu as an option. 


Note: Be cautious if you chose to archive index records to optical or tape (in your 
report policy definitions). There is a condition when using FNDRPTRDAR 
under which you may lose visibility to the report data to which those index 
records relate. 


* Be cautious using the FNDRPTRDAR API when the date range on the 
Spreciry DocuMENT SEARCH screen is broadened (after entering a search key 
value). Under these parameters, OnDemand only searches on disk for the 
index records of reports whose dates differ from the original report date. 
This is by design; otherwise it could cause an optical disk or tape mount 
for every volume on which OnDemand has index records stored. 


Add the Spreciry Report SEARCH (OnDemand logo) screen to a Control Language (CL) 
program or as a menu option on a Screen Design Aid (SDA) menu, use the 
FNDRPTRDAR command with no additional parameters. 


Optional parameters are available to further define your retrieval request. The 
parameters are: 


* Report name - 10 bytes 


Enter the complete report name, a partial (generic) name followed by an asterisk 
(*), or *SELECT to cause the report name to be selected from the report retrieval 
screen. 


* Report date range - From date - 8 bytes, defaults to *AVAIL 
* Report date range - To date - 8 bytes, defaults to *CURRENT 
* Display report selection - 4 bytes, defaults to *YES. 


Entering *YES will cause the Spsciry Report SEARCH (OnDemand logo) screen to 
display, allowing the user to enter any OnDemand report name. Entering *NO 
will bypass the Sreciry Report SEARCH screen and take the user directly to the 
SpeciFY DocuMENT SEARCH screen, allowing the user to enter specific search criteria 
(keys) for a particular report. 


This bypass option requires entering a valid report name in the Report name 
parameter. If you have more than one report version (for example, version 01 
and 02) defined for the report, OnDemand will use *HIGHEST to determine the 
key field names and column headings on the OnDemand screens. 

To see the format of the fields in this API: 


Enter FNDRPTRDAR and press F4. 


“Option 1. Retrieve Reports” on page 72}explains the screens and fields. 
To use this option, users must be granted OnDemand security authorization. (See 
Chapter 1, “Using the OnDemand Spool File Archive Feature” on page 1}) 


FNDKEYRDAR Application Programming Interface 


Use FNDKEYRDAR to add OnDemand report retrieval functions to your existing 
interactive applications. 


In your application program, you can define a new function key that uses 
FNDKEYRDAR to add the OnDemand report retrieval functions to your existing 
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application. For example, assume a customer inquiry application exists that lets 
end users enter a customer number to display a customer’s data. You can define a 
new function key on the application’s inquiry screen to find all invoices that are 
stored within OnDemand for that customer. While looking at the information on 
the screen for a particular customer, the end user can press the new function key. 
This causes OnDemand to display a selection list for viewing, printing, or sending 
a facsimile of invoices for that customer. After the end user views, prints, or faxes 
the invoices of interest, OnDemand passes control back to your customer inquiry 
application as if the user never left your screen. 


Note: Be cautious if you chose to archive index records to optical or tape (in your 
report policy definitions). There is a condition when using FNDKEYRDAR 
under which you may lose visibility to the report data to which those index 
records relate. 


* If you use the FNDKEYRDAR API, the API will only search the index 
records on disk. This is by design; otherwise it could cause an optical 
disk or tape mount for every volume on which OnDemand has index 
records stored. 


An easy way to utilize the FYVDKEYRDAR API is to put it in a control language 
(CL) program. Then call that CL program from your existing application program 
(by passing parameters as needed). There is an example of a CL program to do this 
in the QSAMPLES source file in the QRDARS library. 


To call the OnDemand Client Viewer by using the FYVDKEYRDAR API, refer to the 
source member PROFILE in the QSAMPLES source file in QRDARS library for 
setup instructions. 


The fields exchanged between your calling program and the API are: 
* Report name - 10 bytes 

* Key 1 - 25 bytes 

* Key 2 - 20 bytes 

* Key 3 - 20 bytes 

* Key 4 - 20 bytes 

* Key 5 - 15 bytes 

* Group search - 4 bytes, defaults to *NO 

* Report date range - From date - 8 bytes, defaults to *AVAIL 

* Report date range - To date - 8 bytes, defaults to *CURRENT 

* Output - 6 bytes, defaults to * (display); could also be set to *PRINT or *FAX. 


Note: If you have more than one report version (for example, version 01 and 02) 
defined for the report, OnDemand will use *HIGHEST to determine the key field 
names and column headings on the OnDemand screens. 

To see the format of the fields in this API: 

Enter FNDKEYRDAR and press F4. 


This list includes escape messages for which you can choose to monitor in the CL 
program that issues this API: 


¢ CPFO0001 Error on command. 
* RDROOO1 Report definition not found. 
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* RDR0006 No documents found with this key. 

* RDRO0007 From Date must be entered with To Date. 

* RDROO10 Page number must not exceed 999999. 

* RDROO11 Page number must be numeric. 

* RDROO13 Segment number must not exceed 999999. 

* RDRO053 Access denied. Not authorized to access this report. 

* RDR0054 Severe directory problem. 

* RDRO105 To date not valid. 

* RDRO0136 Cannot search using Key2 and Key3. 

* RDRO137 Cannot search using Keyl and Key3. 

* RDRO183 You are not authorized to the document with this key. 

* RDRO252 Only RPTKEY1 can be specified with RPTTYPE(*PAGE). 
* RDRO253 RPTKEY4 or RPTKEY5 cannot be specified with RPTTYPE(*7NODX). 


* RDR2882 Client launch API program QRLRLCV ended with error code &1. (This 
is for AnyStore documents only.) 


* RDR9IIII No more licenses for OnDemand are available. 


Advanced APIs 


For more advanced functions to add to your applications, refer to the detail in this 
section. These advanced Spool File Archive APIs allow you to: 


* Retrieve a list of Spool File Archive segments 
* Retrieve a specific Spool File Archive segment 
* Retrieve a group of archived indexes 

* Retrieve a specific set of archived resources 


Each API has a fixed number of parameters that must be passed. Errors are 
controlled by the error code parameter except in the case where an escape message 
is sent to terminate the call due to: 


* There is no room to return the error code 
* The error is definitional and requires a recompilation of the program 


* The error is not dependent on the result of the API 


These advanced APIs can be run in batch or interactive jobs, although the API for 
viewing would not typically be appropriate for a batch job. 


Error Code Parameter 


All APIs include an error code parameter that returns error codes and exception 
data to the calling application. The error code parameter is a variable length 
structure that contains the information that is associated with an error condition. 
The error code parameter can be one of two variable-length structures, format 
ERRCO0100 or format ERRC0200. 


In format ERRCO0100, one field in that structure is an INPUT field. This INPUT 
field controls whether an exception returns to the application or the error code 
structure fills in with the exception information. When the Bytes provided field is 
greater than or equal to 8, the rest of the error code structure fills in with the 
OUTPUT exception information that is associated with the error. When the Bytes 
provided INPUT field is zero, all other fields are ignored, and an exception 
returns. 
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Use Format ERRC0200 if the API caller wants convertible character (CCHAR) 
support. Format ERRC0200 contains two INPUT fields. The first field, called the 
Key field, must contain a -1 to use CCHAR support. When the Bytes provided 
field is greater than or equal to 12, the rest of the error code structure fills in with 
the OUTPUT exception information that is associated with the error. When the 
Bytes provided INPUT field is zero, all other fields are ignored, and an exception 
returns. 


Note: To determine if an error occurred, you should check to see if the Bytes 
available is greater than 0. Checking for a non-blank value in the exception 
id is not a valid method. 


The structure of the error code parameter is as follows: 


Format ERRC0100 


Offset 
Dec | Hex | Use Type Field 
0 0 |INPUT | Binary(4)| Bytes provided 
4 4 |OUTPUT) Binary(4)| Bytes available 
8 8 |OUTPUT|Char(7) | Exception ID 
15 F |OUTPUT|Char(1) | Reserved 
16 | 10 |OUTPUT] Char(*) | Exception data 


Format ERRC0200 


Offset 
Dec | Hex | Use Type Field 

0 0 |INPUT | Binary(4)| Key 

4 4 |INPUT |Binary(4)| Bytes provided 

8 8 |OUTPUT|] Binary(4)| Bytes available 

12 | C |OUTPUT) Char(7) | Exception ID 

19 | 13 |OUTPUT|Char(1) | Reserved 

20 | 14 | OUTPUT] Binary(4)|CCSID of the CCHAR data 

24 | 18 | OUTPUT] Binary(4)| Offset to the exception data 

28 | 1C | OUTPUT] Binary(4)| Length of the exception data 
OUTPUT) Char(*) | Exception data 


Field Descriptions 


Bytes available 
The length of the error information available to the API, in bytes. If this is 
0, no error was detected. 


Bytes provided 
The length of the area that the calling application provides for the error 
code. If the API caller is using format ERRC0100, the bytes provided must 
be 0, 8 or more that 8. If the API caller is using format ERRC0200, key the 
bytes provided must be 0, 12, or more than 12. 
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0 If an error occurs, an exception is returned the application to indicate that 
the requested function failed. 


8 If an error occurs, the space is filled in with the exception information. No 
exception is returned. This only occurs if format ERRCO0100 is used. 


12 If an error occurs, the space is filled in with the exception information. No 
exception is returned. This only occurs if format ERRC0200 is used. 


CCSID of the CCHAR data 
The coded character set identifier (CCSID) of the convertible character 
(CCHAR) portion of the exception data. The default is 0. 


0 The default job CCSID. CCSID A valid CCSID number. The valid CCSID 
range is 1 through 65535, but not 65534. 


Exception data 
A variable-length character field containing the substitution text for the 
exception. You can use the SNDPGMMSG or SNDUSRMSG CL commands 
to send a message to someone by specifying the exception id as the value 
for the MSGID parameter and the exception data as the value for the 
MSGDATA parameter on these commands. Messages can also be sent 
using the Message Handler APIs. 


Exception ID 
The identifier for the message for the error condition. Ids that start with 
RDR can be found in the message file QRLCMSGF in library QRDARS. 


Key The key value that enables the message handler error function if CCHAR 
support is used. This value should be -1 if CCHAR support is expected. 


Length of the exception data 
Length of the exception data. The length, in bytes, of the exception data 
returned in the error code. 


Offset to the exception data 
Offset to the exception data The offset from the beginning of the error code 
structure to the exception data in the error code structure. 


Reserved 
A 1-byte reserved field. 


Retrieve Key List (QrirRetrieveReportKeyList) API 


Parameters 

Required Parameter Group: 
1| Receiver variable Output Char(*) 
2) Length of receiver variable | Input Binary(4) 
3] Receiver variable format | Input Char(8) 
4| From segment key Input Char(*) 
5| To Segment key Input Char(*) 
6| Segment key format Input Char(8) 
7 | Maximum segments to Input Binary(4) 

retrieve 

8 | Continuation handle Input Char(16) 
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Parameters 


Omissible Parameter Group: 


9 | Request index status Input Char(10) 
10 | Index status Output Char(1) 
11 | Error code 1/O Char‘(*) 


Service Program: QRLRRAPI 


Threadsafe: No. 


The Retrieve Key List (QrlrRetrieveReportKeyList) API retrieves a list of all 
segments that match the keys specified. Generic and range searches are allowed. 
Following the key value with an asterisk (*) signifies a generic search. Specifying 
more than one key, causes the search to follow the order of the keys that are listed 
in the segment key parameter. Specify at least one key. If a key field is blank, it is 
considered unspecified. Generic searches can only be specified for the keys 
specified in the From segment key variable. If they are specified for the To 
segment key variable, it is not a valid search request. The list of segments that are 
found is placed in the receiver variable. The list of segments contains only key 
values for which the user is authorized. 


Attention: Security checking is based on the current user. If this API is being 
used in a server job that is not running under the user’s authority, then the server 
job’s user profile is used. This can be avoided by switching to the true user’s 
profile before calling this API. 


Authorities and Locks 


Library Authority 
*EXECUTE 


File Authority 
*USE 


Data Area Authority 
*USE 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) Contains the key of the segments found. Format of this 
variable is specified by the receiver variable format field. 


Length of receiver variable 
INPUT; BINARY(4) Length of the receiver variable. It should be large 
enough to hold the maximum number of segments plus the length of the 
non-repeating part of the format. For format SEGF0100 the non-repeating 
part is 36 bytes. 


Receiver variable format 
INPUT; CHAR(8) Format of the receiver variable. 


* SEGFO0100: RetrieveReportKeyList format 


See |“Format of RetrieveReportKeyList” on page 309|for a description of 


these formats. 
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From segment key 
INPUT; CHAR(*) Starting key(s) or only key(s) to search with. Format is 
specified by segment key format field. 


To segment key 
INPUT; CHAR(*) Segment key to end search with. Only used when 
performing range searches. Format is specified by segment key format 
field. 


Segment key format 
INPUT; CHAR(8) Format of the segment key. 


* KEYA0100: Key format 


See |“Format of Segment Keys” on page 308| for a description of these 


formats. 


Maximum segments to retrieve 
INPUT; BINARY(4) Specifies the maximum segments to be placed in the 
segment list. Must be 1 to 9999. 


Continuation handle 
INPUT; CHAR(16) This field must either contain blanks or a valid 
continuation handle. If it is blanks, a new search is performed with the 
provided key values. If it is a valid continuation handle from a previous 
call, then the search is continued from where it left off. 


Omissible Parameter Group 


Request index status 
INPUT; CHAR(10) Request information on the status of the indexes for a 
specific report. Specify a report name or no index status returns. Specify a 
date range in the From segment and To segment key formats. Otherwise, 
the requesting index status will most likely not provide any meaningful 
information because OnDemand would search for any archived index for 
this report. This is because not specifying a date range results in a check 
for any archived index of this report since the installation of OnDemand. 
Limiting the searched data to a specific date range allows the Request 
index status to indicate any indexes that are archived within that range. 
This gives you a better indication of the search completion. The default 
value for this parameter is *NO. Valid values for this field are: 


e *YES: Return index status in index status field. 
¢ *NO: Do not return index status. 
Index status 


OUTPUT; CHAR(1) Indicates where the indexes are for the specified report 
date combination. Values for this parameter are: 


* 0: All indexes with in the specified date range are on disk. 
* 1: At least one index is archived to tape or optical. 


Error code 
I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 303 
Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3C21 
Format name &1; is not valid. 
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CPF3CF1 
Error parameter is not valid. 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3 
RDR2153 
Unable to obtain proper license. 
RDR2205 
Authority error. 
RDR2301 
Search requested not valid. 
RDR2302 
Date is not valid. 
RDR2303 
Maximum segments requested is not valid. 
RDR2304 


Retrieve list error. 


Format of Segment Keys 
KEYA0100 Format: This format defines the starting and ending key values to 
search with. 


Offset 
Dec | Hex | Type Field 
0 0 | CHAR(10) Report Name/Group Name 
10 | A |CHAR(2) Version 


12 | C |CHAR(25) Key 1 
37 | 25 |CHAR(20) Key 2 
57 | 39 | CHAR(20) Key 3 
) 
) 


77 | 4D | CHAR(20 Key 4 
97 | 61 | CHAR(I5 Key 5 
112 | 70 | CHAR(8) Date YYYYMMDD 


Field Descriptions At least one of the fields Key 1 thru Key 5 must be specified or 
message RDR2301 will be issued. 


Date Date to search for in the format of YYYYMMDD or blanks. When blank 
field will not be used as part of the search criteria. 


Key 1 Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 


Key 2 Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 


Key 3 Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 


Key 4 Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 


Key 5 Value to search for or blanks. When blank field will not be used as part of 
the search criteria. 
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Report/Group name 
Report or group name to use. When a report name is provided then only 

the keys for that report are searched. When a group name is used then the 
keys for all reports in the group are searched. A group abbreviation can be 


provided also by using the special form *GRPABVnnn where nnn is the 


three letter group abbreviation. No checking is done for this value. If this 
field is specified in both the segment and to segment key variables then it 


must be the same value in each. The use of ”’ for generic search is not 


allowed for this field. 


Version 


Report version 01 - 99 or blanks. When blank field will not be used as part 
of the search criteria. 


Format of RetrieveReportKeyList 
The key list can repeat up to 9999 times as required. 


SEGF0100 Format: This format defines the returned segment information. 


Offset 
Dec | Hex | Type Field 
BINARY(4) Bytes returned 
4 4 |BINARY(4) Bytes available 
CHAR(16) Continuation handle 
24 | 18 | BINARY(4) Offset to segment information list 
28 | 1C | BINARY(4) Number of segment list entries 
32 | 20 | BINARY(4) Length of segment list entry 


Note: Format of the entries in the segment list. The following 
fields are repeated for each segment list entry. The decimal and 
hexadecimal offsets depend on the number of segment list entries. 
The first segment list entry is found by using the offset to 


segment list entries. 


CHAR(10) 


Report Name 


CHAR(2) 


Version 


PACKED(11 0) 


Compressed length 


PACKED(11 0) 


Full length 


PACKED(11 0) Displacement 
CHAR(25) Key 1 
CHAR(20) Key 2 
CHAR(20) Key 3 
CHAR(20) Key 4 
CHAR(15) Key 5 

CHAR(8) Date 

CHAR(1) Period 
CHAR(3) Sequence number 
CHAR(1) Reserved 
CHAR(16) Segment handle 


Field Descriptions 


Appendix A. OnDemand Spool File Archive User Exits and Application Programming Interfaces 


309 


310 


Bytes available 
The length of the RetrieveReportKeylist in bytes. 


Bytes returned 
The length of data returned in the RetrieveReportKeylist in bytes. 


Compressed length 
Size of the segment after it is compressed. 


Continuation handle 
This field is blank if the segment list entries contain all the keys that match 
the specified search. If more entries are available then it contains a handle 
that can be used to continue the search at the point it left off. 


Date Date of the segment in the format of YYYYMMDD 


Displacement 
Offset from the beginning of the object to this segment. 


Full length 
This field contain either the uncompressed length of the segment or the 
resource group id (negative number). 


Key 1 Value of key1 
Key 2 Value of key2 
Key 3 Value of key3 
Key 4 Value of key4 
Key 5 Value of key5 


Length of segment list entry 
The length of each segment list entry. 


Number of segment list entries 
The number of entries returned in the list. 


Offset to segment list information 
Offset in bytes from the beginning of the format to the segment list entries. 


Period Always contains a period. 


Report name 
Name of report. 


Reserved 
This byte is reserved for later use. 


Segment handle 
Access handle for this segment. 


Sequence number 
Sequence number of archived Object. 


Version 
Report version. 


Retrieve Segment (QrirRetrieveReportSegment) API 


Parameters 


Required Parameter Group: 


1 | Receiver variable Output Char(*) 
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2| Length of data returned Output Binary(4) 
3| Record length of data Output Binary(4) 
returned 
4| Segment index Input Char‘(*) 
5 | Segment index format Input Char(8) 
6| Retrieve information Input Char(*) 
7 | Retrieve information Input Char(8) 
format 
8| Print data type Output Char(10) 
9| Report ID Output Binary(4) 
10| Error code 1/O Char(*) 


Service Program: QRLRRAPI 


Threadsafe: No. 


The Retrieve Segment (QrirRetrieveReportSegment) API retrieves the specified 
segment and places it either in the receiver variable, or where the retrieve 
information specifies. 


Attention: 

* Run this API by using the same user profile that ran the Retrieve Key List 
(OrlrRetrieveReportKeyList) API, or the segment access handle will not be 
valid. 

* If enabled, the combined view, print, and fax report options are ignored when 
using this API. 

* If enabled, the viewer option to launch the CA/400 viewer (also known as the 
AFP viewer) is supported by this API. However, the viewer option to launch the 
OnDemand Client viewer is ignored. If your application requires launching the 


OnDemand client viewer, see “OnDemand Client Driver API” on page 318 


Authorities and Locks 


Library Authority 
*EXECUTE 


File Authority 
*CHANGE 


Required Parameter Group 


Receiver variable 
Output; CHAR(*) The field to contain the output. 


Length of data returned 
Output; BINARY(4) Length of data placed in receiver variable. 


Record length of data returned 
Output; BINARY(4) Record length of data placed in receiver variable. If this is 
0 the data has a self-defining format. 


Segment index 
INPUT; CHAR(*) Contains index of the segment to retrieve. Format is specified 
in Segment index format. 


Segment index format 
INPUT; CHAR(8) Format of the segment index variable. Do not change any of 
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the variables provided from the Retrieve Key List 
(OrlrRetrieveReportKeyList) API segments. Changing the report name, 
compressed length, displacement, data, or sequence number will result in 
unpredictable results. If the segment handle is not correct, message RDR2407 is 
issued. 


SEGD0100 
Segment index format 


See |“Retrieve Segments Formats” on page 313|for a description of these 


formats. 


Retrieve information 
Input; Char(*) The character field that contains required retrieve information. 
The format of the field is determined by the retrieve information format field. 


Retrieve information format 
Input; Char(8) Format of the retrieve information field. See|“Retrieve] 
ee el, the description of these formats. The 
following values are valid: 


RTVS0100 
Retrieve segment spool data to a buffer 


RTVS0200 
Display segment spool data by using OnDemand viewer 


Print data type 
Output; Char(10) The type of data stream that the spooled data is in. The 
following values are valid: 


*AFPDS 
Advanced Function Printing" data stream 


*AFPDSLINE 
AFPDS data mixed with line data 


*LINE Line data with *FCFC 


*OTHER 
Line data with *FCFC 


*SCS_ SCS data 
Report ID 
Output; Binary(4) The report id of the report segment being retrieved. 


Error code 
I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 303 


Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3C21 
Format name &1; is not valid. 


CPF3CF1 
Error parameter is not valid. 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3. 
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RDR2153 
Unable to obtain proper license. 


RDR2401 
Retrieve read error. 


RDR2406 
Segment open error. 


RDR2407 
Insufficient authority. 


RDR2409 
Recalled from tape. 


RDR2411 
Retrieve buffer length not valid. 


RDR2414 


Retrieve segment error. 


Retrieve Segments Formats 
SEGD0100 Format: This format defines the input segment information. 


Offset 
Dec | Hex | Type Field 
0 0 |CHAR(10) Report Name 
10 | A |CHAR(2) Version 


12 | C |PACKED(11 0) Compressed length 
18 | 12 | PACKED(11 0) Full length 

24 | 18 | PACKED(11 0) Displacement 

30 | 1E | CHAR(25) Key 1 


55 | 37 | CHAR(20) Key 2 

75 | 4B | CHAR(20) Key 3 

95 | 5F | CHAR(20) Key 4 

115 | 73 | CHAR(15) Key 5 

130 | 82 | CHAR(8) Date 

138 | 8A | CHAR(1) Period 

139 | 8B | CHAR(3) Sequence number 
142 | 8E | CHAR(1) Reserved 

143 | 8F | CHAR(16) Segment handle 


Field descriptions 


Compressed length 
Size of the segment after it is compressed. 


Continuation handle 


This field is blank if the segment list entries contain all the keys that match 
the specified search. If more entries are available then it contains a handle 


that can be used to continue the search at the point it left off. 


Date Date of the segment in the format of YYYYMMDD. 
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Displacement 
Offset from the beginning of the object to this segment. 


Full length 
This field contain either the uncompressed length of the segment or the 
resource group id (negative number). 


Key 1 Value of key1 
Key 2 Value of key2 
Key 3 Value of key3 
Key 4 Value of key4 
Key 5 Value of key5 


Length of segment list entry 
The length of each segment list entry. 


Number of segment list entries 
The number of entries returned in the list. 


Offset to segment list information 
Offset in bytes from the beginning of the format to the segment list entries. 


Period Always contains a period. 


Report name 
Name of report. 


Reserved 
This byte is reserved for later use. 


Segment handle 
Access handle for this segment. 


Sequence number 
Sequence number of archived Object. 


Version 
Report version. 


Retrieve Information Formats 
RTVS0100 Format: Defines format to retrieve segment spool data into a buffer. 


Offset 
Dec | Hex | Type Field 
0 0 |BINARY(4) | Length of receiver variable 


RTVS0100 Field Description 


Length of receiver variable 
Contains length of receiver variable. Maximum length is 2 million bytes. 
The required length for this field for a specific segment may be provided 
from the full length field of segment list entry. If the full length field is 
positive it contains the needed length, if it is negative then it represents the 
resource id. If it is a resource id then you can either use 2 million bytes as 
the size or estimate the size by multiplying the compressed length of the 
segment list entry by 10 


RTVS0200 Format: This defines format to display segment spool data by using the 
OnDemand viewer. 
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Offset 
Dec | Hex | Type Field 
0 0 |BINARY(4) | Action to take 


RTVS0200 Field Description 


Action to take 
The valid values are. 


* 1 Display the segment data 
* 2 Print the segment data 
* 3 Fax the segment data 


Retrieve Archived Indexes (QrirRetrieveArchivedindexes) API 


Parameters 


Required Parameter Group: 


1| Report name Input Char(10) 
Start date Input Char(8) 
End date Input Char(8) 
Initiate recall Input Char(10) 
Number of reports Output Binary(4) 
Number of index entries | Output Binary(4) 
Error code 1/O Char(*) 


Service Program: QRLRRAPI 


Threadsafe: No. 


The Retrieve Archived Indexes (OQrlrRetrieveArchivedIndexes) API returns 
information about the number of reports with archived indexes within the 
specified date range. Optionally it recalls the indexes to back to the disk. 


Attention: If the number of indexes is large, then the index recall may take a long 
time. 
Authorities and Locks 


Library Authority 
*EXECUTE 


File Authority 
*USE 
Required Parameter Group 


Report name 
Input; CHAR(10) Name of report 


Start date 
Input; CHAR(8) Starting date to retrieve indexes in the format YYYYMMDD. 
This field must be specified. 
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Ending date 
INPUT; CHAR(8) Date after which to stop retrieving indexes in the format 
YYYYMMDD. If this field is blank, it defaults to start date. 


Initiate index recall 
INPUT; CHAR(10) Requests the performance of a recall for the indexes that are 
specified by the report date range combination. If all indexes for the report 
date combination are on disk, then OnDemand issues message RDR2305. Valid 
values for this field are: 


*YES Initiate index recall. 
*NO _ Do not initiate index recall. 


Number of reports 
Output; BINARY(4) The total number of reports which have indexes archived 
for the date range entered. If initiate recall was *YES, then this is the number 
or reports whose indexes were recalled. 


Number of index entries 
Output; BINARY(4) The minimum number of index entries in the archived 
reports. This is the minimum because multi-key report can have multiple 
indexes per segment. 


Error code 
I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 303 


Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3CF1 
Error parameter is not valid. 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3. 


RDR2153 
Unable to obtain proper license. 


RDR2305 
No indexes to retrieve. 


Retrieve Archived Resource (QrirRetrieveArchivedResource) 


API 

Parameters 

Required Parameter Group: 
1 | Receiver variable Output Char(*) 
2| Length of receiver variable | Input Binary(4) 
3| Length of data returned Output Binary(4) 
4| Receiver variable format | Input Char(8) 
5 | Report group id Input Binary(4) 
6 | Resource id Input Binary(4) 
7 | Error code 1/O Char(*) 
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Service Program: QRLRRAPI 


Threadsafe: No. 


The Retrieve Archived Resource (QrlrRetrieveArchivedResource) API will return 
information about the specified resource ID or will return the specified resource to 
the receiver variable. 


Authorities and Locks 


Library Authority 
*EXECUTE 


File Authority 
*CHANGE 


Required Parameter Group 


Receiver variable 
Output; CHAR(*) The field to contain the output. 


Length of receiver variable 
Input; BINARY(4) Length of the receiver variable. 


Length of data returned 
Output; BINARY(4) Length of the data returned. 


Receiver variable format 
Input; CHAR(8) Format of the receiver variable. See|“Receiver Variable 
Formats” on page 318]for the description of these formats. The following 
values are valid: 
* RSCF0100: Retrieve resource information 
* RSCF0200: Retrieve the resource 

Report group id 
INPUT; BINARY(4) The report group id. Determine this by dividing the 
report id by 100 and truncating the result to a whole number, then 


multiplying the result by 100. For example: report id = 531, 531/100 = 5.31, 
truncate 5.31 to 5, 5 * 100 = 500. So the group id is 500. 


Resource ID 
Input; BINARY(4) The id of the resource. This id is provided in the 
segment list entry field full length. If the full length is negative, then the 
absolute value of it is the resource id. 


Error code 
I/O; CHAR(*) The structure in which to return error information. For the 


format of this structure, see |“Error Code Parameter” on page 303 


Error Messages 


CPF24B4 
Severe error while addressing parameter list. 


CPF3CF1 
Error parameter is not valid 


CPF9872 
Program or service program &1; in library &2; ended. Reason code &3. 


RDR2153 
Unable to obtain proper license. 
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Receiver Variable Formats 
RSCF0100 Format: Defines format to retrieve the resource information. 


Offset 
Dec | Hex | Type Field 

0 0 |BINARY(4) | Number of resources in the group 

4 4 |BINARY(4) _ | Total length of all the resources 


RSCF0100 Field Description 


Number of resources in the group 
Contains the count of resources in the group. 


Total length of all the resources 
Contains the length of all the resources. 


RSCF0200 Format: Defines format to retrieve the resources. 


Offset 
Dec | Hex | Type Field 
0 0 |BINARY(4) | Buffer to hold the resource. 


RSCF0200 Field Description 


Buffer to hold the resource 
This buffer must be at least as large as the full length received in the 
RSCFO0100 format. When the resource group is returned, this buffer 
contains the AFPDS data stream that defines the resources. 


Total length of all the resources 
Contains the length of all the resources. 


OnDemand Client Driver API 


This section describes the Client Driver API, which allows an iSeries application to 
send information to the OnDemand client workstation viewer program. The intent 
is to provide a mechanism by which you can use the viewer program to display 
documents from the OnDemand database. Ideally, you accomplish this with little 
or no interaction between the user and the viewer program. 


This function is comprised of two parts: 
* The API on the iSeries, with which the application program will interact. 


* A companion program that is residing on the workstation, which is the interface 
between the iSeries API and the viewer. 


For this function to operate correctly, you must address several operational and 
environmental considerations. This section will describe these considerations. 


There is an example Control Language (CL) program to launch the Client Viewer 
in the QSAMPLES source file in the QRDARS library. 


You can also call the OnDemand Client Viewer by using the FNDKEYRDAR API. 


The implementation is faster and easier, but has fewer options available. If you do 
not require the full set of options that are provided by the advanced Client Driver 
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API, see the |“FNDKEYRDAR Application Programming Interface” on page 301 


section of this appendix for more information. 


Launch Client Viewer (QRLRLCV) API 

The API has a required fixed number of parameters to pass. Errors return through 
the error code parameter except when the system receives an escape message sent 
to end the call due to one of the following conditions: 


* There is no room to return the error code. 
* The error is definitional and requires a recompilation of the program. 
* The error is not dependent on the result of the API. 


Parameters 


Required Parameter Group: 


1} Data structure to pass to | Input Char(300) 
viewer program 

2 | Format name Input Char(8) 

3 | Error code 1/O Char(*) 


Data structure to pass to viewer program 
Input; CHAR(300) 


This structure contains the search request that is sent to the viewer program. 
You will find the format of the ODCLO100 structure, along with a description 
of its fields presented below. 


Format name 
Input; CHAR(8) 


The format of the data sent. Specify ODCLO0100. 


Error code 
I/O; CHAR(*) 


A variable length structure containing the information associated with an error 
condition. 
Structure Definitions: 


ODCLO0100 Format 
This format defines the retrieval request. All fields are input fields. 


Offset 

Dec Hex Type Field 

0 0 Char(10) Report name 

10 0A Char(6) Sequence number 
16 10 CHAR(3) Date comparator 
19 13 CHAR(8) Date value 1 

27 1B CHAR(8) Date value 2 

35 23 CHAR(3) Key 1 comparator 
38 26 CHAR(25) Key 1 value 1 

63 3F CHAR(25) Key 1 value 2 

88 58 CHAR(3) Key 2 comparator 
91 5B CHAR(25) Key 2 value 1 
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Offset 

Dec Hex Type Field 

116 74. CHAR(25) Key 2 value 2 

141 8D CHAR(3) Key 3 comparator 
144 90 CHAR(25) Key 3 value 1 

169 A9 CHAR(25) Key 3 Value 2 

194 C2 CHAR(3) Key 4 comparator 
197 C5 CHAR(25) Key 4 value 1 

222 DE CHAR(25) Key 4 value 2 

247 F7 CHAR(3) Key 5 comparator 
250 FA CHAR(25) Key 5 value 1 

275 113 CHAR(25) Key 5 value 2 


You must specify a value for report name. Also, specify at least one search 
argument. You can meet this requirement either by specifying date search value or 
key search value. 


Field Descriptions: 


Report name 


The name of the report or group on which to perform the search. 


Sequence number 
The sequence number of the desired document. The values which you may 
specify are: 


*FIRST 


*LAST 


*ANY 


nnn 


blank 


Opens the first document which appears in the document list that 
is retrieved by the client viewer. 


Opens the last document which appears in the document list that 
is retrieved by the client viewer. 


(Default) If only one document appears in the list of documents 
retrieved by the client, it is opened. Otherwise, the system displays 
the list. 


Opens the first document in the list of documents that are 
retrieved by the client viewer which has a sequence number that 
matches the number that is specified by nnn. You should 
left-justify this 3-digit number in the field. 


If this field is blank, *ANY is assumed. 


Date comparator 
The type of date comparison you want the system to make. The allowed 
values are: 


*EQ 
*BW 
blank 


Searches only documents with a specified date. 
Searches documents having a date within a specified range. 


Searches documents within the default date range. This is usually a 
30-day range unless you have defined a different default date 
range in the report definition. 
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Date value 1 
A date, in the format YYYYMMDD. Depending on the value of the date 
comparator, this field has the following meaning: 


If the date comparator is *EQ, this value specifies the single date for which 
documents are to be searched. You can also specify *CURRENT to search 
for documents with today’s date. 


If the date comparator is *BW, this value represents the oldest date for 
which documents are to be searched. You can also specify *AVAIL to search 
for documents starting with the oldest available date. 


Date value 2 
A date, in the format YYYYMMDD, which is used only if the date 
comparator is *BW. This represents the highest date for which reports will 
be searched. You can also specify *CURRENT to search for documents up 
to and including today’s date. 


(The following set of three fields is repeated for each of the five possible keys which 
can be searched. A key is searchable if the "minimum search characters" value for 
that key in the report definition is non-zero. For PAGE and NODX reports, the 
searchable keys are 1 and 3 only.) 


Key comparator 
The type of key comparison to perform. The allowed values are: 


- Range comparators - 


*BW _ Search for key values which are within a range that is specified by 
a lower value and upper value. 


*NB __ Search for key values which are not within a range that is specified 
by a lower value and upper value. 

- List comparators - 

*IN Search for key values which are in a list of specified values. 


*NI Search for key values which are not in a list of specified values. 


- Single-value comparators - 

*EQ Search for a key which matches a specified value. 

*NE _ Search for a key which does not match a specified value. 

*LT Search for a key which is less than a specified value. 

*GT Search for a key which is greater than a specified value. 

*LK Search for a key which matches a specified pattern of characters. 


*NL Search for a key which does not match a specified pattern of 
characters. 


*LE Search for a key which is less than or equal to a specified value. 
*GE Search for a key which is greater than or equal to a specified value. 


Key value 1 and Key value 2 
These fields are used to specify the values for searches which are based on 
a key value. Depending on the key comparator, provide data in key value 
1 and key value 2 as follows: 


For *BW and *NB, specify the low value for the range in key value 1, and 
specify the high value in key value 2. 
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For *IN and *NI, use both fields as one concatenated 50-byte field to 
specify a list of two or more values that are separated by at least one blank 
character. 


For all other values (single-value searches), specify the key search 
argument in key value 1, and do not specify anything for key value 2. 


Note: For PAGE and NODX reports, the comparator value is restricted to *EQ 
only. 


Error Structure Format: The structure of the error code parameter is as follows: 


Offset 
Dec Hex Use Type Field 
0 0 INPUT Binary(4) Bytes provided 
4 4 OUTPUT Binary(4) Bytes available 
8 8 OUTPUT Char(7) Exception ID 
15 F OUTPUT Char(1) Reserved 
16 10 OUTPUT Char(*) Exception data 


One field in the structure is an INPUT field. It controls whether an exception 
returns to the application or the error code structure fills in with the exception 
information. When the bytes provided field is greater than or equal to 8, the rest of 
the error code structure fills in with the OUTPUT exception information that is 
associated with the error. When the bytes provided INPUT field is zero, it ignores 
all other fields and returns an exception if detecting an error. 


Note: To determine if an error occurred, you should check to see if the bytes 
available is greater than 0. Checking for a non-blank value in the exception 
ID is not a valid method. 


Field Descriptions - Error structure: 


Bytes provided 
The length of the area that the calling application provides for the error 
structure. The bytes provided must be 0, 8 or more that 8. IBM 
recommends using a value of 19 or greater. 


0 If an error occurs, an exception is returned to the application to 
indicate that the requested function failed. 


8 If an error occurs, the bytes available field will contain a non-zero 
value that indicates the number of bytes of exception data which 
the API could provide. The calling program will not be able to 
determine the nature of the error because the error structure does 
not provide space for the exception data. No exception is returned. 


>8 If an error occurs, the space is filled in with the error information. 
No exception is returned. 


Bytes available 
The length of the error information available to the calling program, in 
bytes. If this is 0, the system detected no error. 
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Exception ID 
The identifier for the message for the error condition. You can find 
message identifiers that start with RDR in the message file QRLCMSGF in 
library QRDARS. 


Reserved 
A 1-byte reserved field. 


Exception data 
A variable-length character field that contains the substitution text for the 
exception. You can use the SNDPGMMSG or SNDUSRMSG CL commands 
to send a message to someone. You do this by specifying the exception id 
as the value for the MSGID parameter and the exception data as the value 
for the MSGDATA parameter on these commands. You can also send 
messages by using the Message Handler APIs. 


The API will return exception ID RDRxxxx for most errors. The specific 
error is reflected in a 3-digit return code which is placed in this field if 
space is provided. For this reason, IBM recommends that you include at 


least 3 bytes of space in this part of the error structure. See 
for Message RDR2694”| for a list of these return codes. 
Operational Considerations 


As stated earlier, there are certain environmental considerations to meet for proper 
the operation of this function: 


* You must install the OnDemand Client Viewer program on the workstation and 
establish a TCP/IP connection from the workstation to the iSeries server. 


* The API companion program must have be started on the workstation. This 
program will call the OnDemand Client Viewer program. The user must log on 
through this viewer program to an OnDemand server system during the startup 
process, or before using of the API. The program is QRLROCD.EXE. 


* The API must be able to determine the IP address of the workstation. Run the 
program that calls the API in a workstation emulation session that is connected 
through TCP/IP. This enables the API to determine the IP address, and requires 
no further action. If the emulation session does not use TCP/IP, the API searches 
for the presence of a data area that has the same name as the device name 
associated with the emulation session. The API searches the library that is 
specified in the library list of the emulation job. If the data area exists, the API 
looks for a non-blank value in bytes 1-15, and uses this value as the workstation 
IP address. It is the responsibility of the user to ensure that this data area exists 
and contains the IP address. You can use the CRTDTAARA and CHGDTAARA 
commands for this purpose. 


Return Codes for Message RDR2694 

The API performs validity checking on the input structure that is specified in 
parameter 1. It also detects errors when sending the search request to the 
workstation companion program. If the API detects an error, the API will assign a 
three-digit return code. Additionally, the API will make this code available in the 
exception data portion of the error structure that is specified in parameter 3. 


If the exception ID is not RDR2694, the exception data will contain information 
specific to the exception ID. 


Listed below are the error codes and their meanings for exception RDR2694. If 
digit 1 is not zero, this indicates that the error pertains to a key search 
specification. Additionally, its value will be 1-5, indicating the key specification in 
error. 
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Digit 1 


Digits 2 - 3 


Error Description 


01 


Database error 


02 


Environment error. A 
connection could not be 
established with the 
workstation companion 
program. 


03 


Report definition was not 
found 


04. 


The report type is not valid 
for the Client viewer 
program. Valid types include 
DOC, PAGE, and NODX. 
ANYS is also valid, provided 
that the data type is 
*BUFFER or *IFS and the 
object class is non-zero. 


05 


Report definition was not 
found. 


06 


The date comparator is not 
valid. 


07 


No date or key value is 
specified. 


08 


The sequence number is 
invalid. 


20 


The key comparator is 
invalid. 


21 


The specified key is not 
searchable. The minimum 
search value for the key is 
zero. 


1-5 


22 


A key comparator is 
specified, but no key values 
are specified. 


23 


A key search value is 
specified, but it is longer than 
the key length specified in 
the report definition. 


91 


The TCP/IP socket could not 
be created. 


92 


Connect failed for TCP/IP 
socket. 


93 


Socket Close operation failed. 
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Appendix B. OnDemand Commands 


Notice of Command Diagrams Deletion 


To find the commands that are listed in the table that is immediately following, 


refer to on-line help. 


COMMAND CORRESPONDING NAME 


SPOOL FILE ARCHIVE COMMANDS 


ADDVIRDAR 
CPYDFNRDAR 


Add to CM from OnDemand. 


Copy report definition. 


DLTRPTRDAR 


Delete Report for OnDemand. 


ENDMONRDAR 


End Monitor for OnDemand 


FNDKEYRDAR 


Find by Key using OnDemand. 


FNDRPTRDAR 


Find Report using OnDemand. 


PRTRPTRDAR 


Print Report for OnDemand. 


PRTITXTRDAR 


Print AFP Spooled File Text using OnDemand. 


RCLRPTRDAR 


Reclaim Report for OnDemand. 


RMVVIRDAR 


Remove from CM for OnDemand. 


STRCDSRDAR 


Start Coded Data Store using OnDemand. 


STRMONRDAR 


Start Monitor for OnDemand. 


STRRMCRDAR 


Start Report Management Cycle using OnDemand. 


WRKADMRDAR 


Work with Administration for OnDemand 


WRKMEDRDAR 


Work with Media for OnDemand. 


WRKSECRDAR 


Work with Security for OnDemand. 


OBJECT ARCHIVE COMMANDS 


STRARCRDAR 


Start Archive using OnDemand. 


STROMCRDAR 


Start Object Management Cycle using OnDemand. 


STRRTVRDAR 


Start Retrieve using OnDemand. 


Printing OnDemand Command Descriptions 


To print the parameter and value descriptions for a command using OS/400, 
follow these instructions: 


To print an entire command do either of the following: 


1. From any command line 
a. Type the command name (for example, STRRMCRDAR) and press 
The display shows general help for the command and help for each 
command parameter. 


b. Press to print the command help. 

2. On the prompt display for a given command 
a. Move the cursor to the top line and press ; 
b. Press 
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Do the following to print the help for one ‘command keyword’ parameter. 


1. From the command line, type the command name and press [J to view the 
command prompt display. 


2. Position the cursor anywhere on the line of the keyword parameter for which 
help is sought and press to display the help for the keyword parameter. 


3. Press to print the help. 
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Appendix C. OnDemand Backup and Recovery 


It is important to implement a backup plan that will serve to protect your data 
archives in the event your organization experiences a disaster, large or small. You 
need to have a plan and prepare so that you can recover. 


Backup Considerations 


Items you need to consider when planning your regular backups include: 
* How to recover the optical or tape media itself 
You should consider having a copy of the media stored at an offsite location. 
* How to recover the data on disk 
You should have procedures in place that backup all of the OnDemand data that 


normally resides on disk, as well as any stored data that has not yet migrated to 
optical or tape. 


Remember: Disk backups will contain database files that reflect the actual archive 
data location and status at the time of backup. DO NOT restore from a backup that 
is one week old. Archived data might have migrated to optical or tape, but 
database control files identify incorrectly the archived data location as disk. In 
order to minimize this situation, you should save QUSRRDARS library and save 
your OnDemand Integrated File System directories on the same schedule to keep 
them synchronized. Perform the backups at least as frequently as after each Report 
Management Cycle (RMC) or Object Management Cycle (OMC). (Possibly even 
more frequently if you often manually delete reports that are stored in 
OnDemand.) 


The particular backup plan you choose to implement will depend on what features 
of OnDemand you are using. All OnDemand installations need to backup the 
items for the base feature. In addition, you must backup the items listed under 
each of the optional OnDemand features that you are using. 


Base Feature 
The following objects need to be saved by the appropriate OS/400 commands: 
* The OnDemand licensed program (5722-RD1) 


* User profiles QRDARS400, QRDARS4001, QRDARS4002, QRDARS4003, 
ORDARS4004, and ORDARS4005 


¢ Authorization list QRDARS400 


This authorization list contains the user profiles that are authorized to use 
OnDemand. 


* Database files in QUSRRDARS library 


Spool File Archive Feature 
The following objects need to be saved by the appropriate OS/400 commands: 
* Database files in QUSRRDARS library 
* Output queues in QUSRRDARS library 


These output queues can contain OnDemand processed spooled files. Saving the 
output queues does not save the data in them. There is no save command to 
save spooled files. 
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* Integrated File System directories 


Each report definition that is created in OnDemand has an Integrated File 
System directory that is named the same as the report definition. To backup 
only the OnDemand spooled file data that resides on disk, you could backup all 
items that are found in the Integrated File System directory 
/QIBM/UserData/RDARS/SpoolFile. 


¢ Authorization lists 


When a report definition is created, an authorization list is also created with the 
same name as the report definition. 


* Data areas in QUSRRDARS library 
These data areas contain the default values for each OnDemand user. 


Object Archive Feature 
The following objects need to be saved by the appropriate OS/400 commands: 
* Database files in QUSRRDARS library 
* IPS directory named /QIBM/UserData/RDARS/Object 


This directory is used to temporarily contain archived objects until the Object 
Management Cycle (OMC) is run and the archive is moved to optical or to tape. 


Record Archive Feature 
The following objects need to be saved by the appropriate OS/400 commands: 
* Database files in QUSRRDARS library 
* User space object in the library where the optical file is located 
* User index object in the library where the optical file is located 
* The model database file on disk in the library where the optical file is located 


AnyStore Feature 


Refer to the list for Spool File Archive Feature above. AnyStore data is stored in 
the same objects and same location as Spool File Archive Data. 


Client/Server Feature 


All Client/Server related data is stored in the same objects and the same location 
as Spool File Archive Data. 


Recovery Considerations 


Contact your OnDemand support provider for instructions on recovering your 
OnDemand archives in the event of a disaster. Many factors can influence the 
recovery plan, depending on the frequency and extent of the backups you have 
available. 


OnDemand Spool File Archive provides a reclaim command for stored spooled 
files that become "lost" due to a problem with the control files that point to them. 
The name of the command is RCLRPTRDAR. This command will re-create a 
spooled file in an output queue and optionally store it again within OnDemand. 


If you must restore the user space or user index objects for an OnDemand Record 
Archive optical file, you should always restore them together as a set. 
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Appendix D. Notices 


This information was developed for products and services offered in the U.S.A. 
IBM may not offer the products, services, or features discussed in this document in 
other countries. Consult your local IBM representative for information on the 
products and services currently available in your area. Any reference to an IBM 
product, program, or service is not intended to state or imply that only that IBM 
product, program, or service may be used. Any functionally equivalent product, 
program, or service that does not infringe any IBM intellectual property right may 
be used instead. However, it is the user’s responsibility to evaluate and verify the 
operation of any non-IBM product, program, or service. 


IBM may have patents or pending patent applications covering subject matter 
described in this document. The furnishing of this document does not give you 
any license to these patents. You can send license inquiries, in writing, to: 


IBM Director of Licensing 
IBM Corporation 

500 Columbus Avenue 
Thornwood, NY 10594. 
U.S.A. 


For license inquiries regarding double-byte (DBCS) information, contact the IBM 
Intellectual Property Department in your country or send inquiries, in writing, to: 


IBM World Trade Asia Corporation 
Licensing 

2-31 Roppongi 3-chome, Minato-ku 
Tokyo 106, Japan 


The following paragraph does not apply to the United Kingdom or any other 
country where such provisions are inconsistent with local law: 
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS 
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER 
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS 
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or 
implied warranties in certain transactions, therefore, this statement may not apply 
to you. 


This information could include technical inaccuracies or typographical errors. 
Changes are periodically made to the information herein; these changes will be 
incorporated in new editions of the publication. IBM may make improvements 
and/or changes in the product(s) and/or the program(s) described in this 
publication at any time without notice. 


Any references in this information to non-IBM Web sites are provided for 
convenience only and do not in any manner serve as an endorsement of those Web 
sites. The materials at those Web sites are not part of the materials for this IBM 
product and use of those Web sites is at your own risk. 


Licensees of this program who wish to have information about it for the purpose 
of enabling: (i) the exchange of information between independently created 
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programs and other programs (including this one) and (ii) the mutual use of the 
information which has been exchanged, should contact: 


IBM Corporation 

Software Interoperability Coordinator 
3605 Highway 52 N 

Rochester, MN 55901-7829 

Las 


Such information may be available, subject to appropriate terms and conditions, 
including in some cases, payment of a fee. 


The licensed program described in this information and all licensed material 
available for it are provided by IBM under terms of the IBM Customer Agreement, 
IBM International Program License Agreement, or any equivalent agreement 
between us. 


Any performance data contained herein was determined in a controlled 
environment. Therefore, the results obtained in other operating environments may 
vary significantly. Some measurements may have been made on development-level 
systems and there is no guarantee that these measurements will be the same on 
generally available systems. Furthermore, some measurement may have been 
estimated through extrapolation. Actual results may vary. Users of this document 
should verify the applicable data for their specific environment. 


Information concerning non-IBM products was obtained from the suppliers of 
those products, their published announcements or other publicly available sources. 
IBM has not tested those products and cannot confirm the accuracy of 
performance, compatibility or any other claims related to non-IBM products. 
Questions on the capabilities of non-IBM products should be addressed to the 
suppliers of those products. 


All statements regarding IBM’s future direction or intent are subject to change or 
withdrawal without notice, and represent goals and objectives only. 


This information is for planning purposes only. The information herein is subject to 
change before the products described become available. 


This information contains examples of data and reports used in daily business 
operations. To illustrate them as completely as possible, the examples include the 
names of individuals, companies, brands, and products. All of these names are 
fictitious and any similarity to the names and addresses used by an actual business 
enterprise is entirely coincidental. 


COPYRIGHT LICENSE: 


This information contains sample application programs in source language, which 
illustrates programming techniques on various operating platforms. You may copy, 
modify, and distribute these sample programs in any form without payment to 
IBM, for the purposes of developing, using, marketing or distributing application 
programs conforming to the application programming interface for the operating 
platform for which the sample programs are written. These examples have not 
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or 
imply reliability, serviceability, or function of these programs. You may copy, 
modify, and distribute these sample programs in any form without payment to 
IBM for the purposes of developing, using, marketing, or distributing application 
programs conforming to IBM’s application programming interfaces. 
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Each copy or any portion of these sample programs or any derivative work, must 
include a copyright notice as follows: 


© (your company name) (year). Portions of this code are derived from IBM Corp. 
Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights 
reserved. 


If you are viewing this information softcopy, the photographs and color 
illustrations may not appear. 


Programming Interface Information 


This publication is intended to help you to use and administer the IBM Content 
Manager OnDemand for iSeries (OnDemand) licensed program. This publication 
documents General-Use Programming Interface and Associated Guidance 
Information provided by the IBM Content Manager OnDemand for iSeries licensed 
program. 


General-Use programming interfaces allow the customer to write programs that 
obtain the services of the IBM Content Manager OnDemand for iSeries licensed 
program. 


Trademarks 


Advanced Function Presentation, Advanced Function Printing, AFP, AS/400, IBM, 
ImagePlus, OfficeVision, Operating System /400, OS/2, OS/400, PS/2, and 
VisualInfo are trademarks of International Business Machines Corporation in the 
United States, other countries, or both. 


Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the 
United States, other countries, or both. 


Lotus is a trademark of Lotus Development Corporation in the United States, other 
countries, or both. 


Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in 
the United States, other countries, or both. 


Other company, product, and service names may be trademarks or service marks 
of others. 


Appendix D. Notices 331 


332 IBM Content Manager OnDemand for iSeries: Administration Guide 


Index 


Special Characters 


"user-defined" data 205 
t++++++4+4++ 282 


A 


absolute processing 
using 19 

additional client/server information 203 

AFP Viewer 140 

AFP Workbench Viewer 140 

AFPDS 12, 74, 80, 203 

annotation (note) 282, 287 

AnyStore 167 

AnyStore object, 169 

AnyStore segment 169 

API, Client Driver 318 

API, Launch Client Viewer 

(QRLRLCV) 319 

application programming interface 
FNDKEYRDAR 301 
FNDRPTRDAR 301 

ATTN key 284 

audit file action codes 139 


backup considerations 327 
Backup Recovery and Media 
Services/400 211 


Cc 


CL program 301 

Client Driver API 318 

combined display 282 

combined fax 283 

combined print 283 

combined view 282 

combined view/print/fax 138 

combining small spooled files 142 

commands 
CPYSPLF 75, 77 
CRIPF 74 
DLTRPTRDAR = 73 
DSPNETA 247 
ENDMONRDAR 86 
FNDKEYRDAR 301 
FNDRPTRDAR 277, 301 
INZOPTVOL = 238 
PRTRPTRDAR 82 
PRITXTRDAR 80 
STRARCRDAR 158 
STRCDSRDAR 72 
STRMONRDAR 84, 294 
STROMCRDAR 161 
STRRMCRDAR 83 
STRRTVRDAR 160 
WRKADMRDAR | 5, 20, 44, 146, 152 


© Copyright IBM Corp. 1997, 2002 


commands (continued) 
WRKCSI 246 
WRKMEDRDAR 211, 214, 216, 218, 
219, 220, 222, 225, 227, 229, 231, 233, 
235, 237, 240, 242, 244 
WRKOUTQ 76 
WRKSECRDAR _ 56, 62, 65 
communications side information 246 
compression 1 
CPYSPLF command 75, 77 
CRTPF command 74 


D 


DLTRPTRDAR command 73 

document reports (DOC) 
segmenting 19 

DSPNETA command 247 


E 


ENDMONRDAR command 86 
exits 
Facsimile 295 
Index (multi-key) 292 
Index (not multi-key) 292 
Input exit 291 
Monitor Output Queue 293 
Monitor Output Queue Date 294 
Unbundle 293 


F 


Facsimile exit 295 
definition 295 
fast-path commands 
GO RDARSM_ 209 
GO RDARSOBJ 145 
GO RDARSRPT 3 
fields 
All sections 29, 49 
Capacity 221 
Description 48 
Environment 28 
From 289 
Group 47 
Initial number of records 75 
Inuse flag 219, 228 
Key 2name 25 
Key 3name 25 
Key 4name 25 
Key 5name 25 
Keys 29, 48 
Media type 214, 216, 218, 220, 223, 
225, 227 
Opt 285 
Optical inuse flag 237 
Optical storage group 230 
Pages in document 285 
Print Line 293 


fields (continued) 
Profile name 67 
Report Date Range 281 
Report Name 293 
Report name/Group name 281 
Report sequence numbers 281 
Report type 281 
Report Version 293 
Search all report sequence 
numbers 281 
Segmentation 29 
Tape device 213, 214, 216, 218 
Tape volume 225 
Time to end 86 
To 289 
User 61 
FNDKEYRDAR command 
application programming 
interface 301 
FNDRPTRDAR command 277, 301 


G 


GO RDARSM 209 

GO RDARSOBJ 145 

GO RDARSRPT 3 

Graphical Access 140 

Graphical User Interface (GUI) 140 
grouping reports 20, 44 

groups, storage 229 

GUI 140 


index archive warning 301, 302 
Index exit (multi-key) 292 
definition 292 
with report definition 292 
Index exit (not multi-key) 292 
definition 292 
with report definition 292 
Input exit 291 
definition 291 
with report definition 291 
integrating OnDemand and AS/400 
problem determination 275 
verifying software installation 252 
integrating OnDemand and iSeries 
overview 249 
integrating OnDemand and OS/400 
installing integration software 251 
INZOPTVOL command 238 
iSeries Access 140 


K 


keys 
change 48 
combinations 24 
key 1 index 19 


333 


keys (continued) 
key 2 index 19 
key 3 index 19 
number of characters 24 
PAGE 105 
partial 24, 281 
report definition keys 24 


L 


LAN 3995 communications 246 

Launch Client Viewer (QRLRLCV) 
API 319 

Line number calculation 136 


M 


Monitor output queue 83, 141 

Monitor Output Queue Date exit 294 
definition 294 

Monitor Output Queue exit 293 
definition 293 


N 


new version 142 

no-index reports (NODX) 
segmenting 19 

note (annotation) 282 


O 


Object Archive 
QARLOAUDIT 163 
Object Management Cycle 
STROMCRDAR command 161 
OCT record selection 162 
OnDemand and VisualInfo for AS/400 
Content Manager external data 
references 249 
removing 250 
integration 
software installation 251 
OnDemand and VisualInfo for iSeries 
Content Manager external reference 
support 249 
integration 249 
optical media 
initialize 238 
optical media management 209 
OS/2 configuration 246 
OS/400 communications side 
information 246 
Output queue monitor 83 
overlays 
AFP 12 
character-based 12 
Overlays, AFP 203 


P 


page buffer 291 
page reports 
segmenting 105 


page reports (PAGE) 
keys 105 
segmenting 19 
partial keys 24, 281 
partially qualified search 280 
pivot value 
processing 19 
problem determination 205 
PRTRPTRDAR command 82 
PRTITXTRDAR command 
report, QPRLRTXT 80 
PS/2 controller 246 


Q 


QPRLCERR 74 
QRDARSADM group profile 56 
QRLRSETP 136 
QRLRSTAT command 

report, QPQUPRFIL 139 
QSAMPLES source file 291 


R 


RCLRPTRDAR command 328 
Record Archive ix 
recovery considerations 328 
Report Definition line number 136 
Report Management Cycle 

QPRLRRMC_ 142 

STRRMCRDAR command 83 
report overlay 

creating 13 
Report Overlay line number 136 
reports 

1-column 104 

2-column 104 

AnyStore 20 

creating a group 20, 44 

document 19 

no-index 19 

page 19,105 

unbundled 19 


S 


samples source file 291 
Screen Design Aid menu 301 
SCS 80 
security 
application level 56 
key level 65, 126 
report group level 62, 126 
report level 58, 126 
system administrator level 56 
user authorization 56 
selecting an OCT record 162 
sequence number 142 
Server, ending 195 
Server, starting 194 
set of archived objects 162 
side information 246 
Spool File Archive 
QARLRAUDIT 139 
QPRLRCDS 142 
Spool File Archive audit file 142 
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statistics reports 139 

storage groups 229 
STRARCRDAR command 158 
STRCDSRDAR command 72 
STRMONRDAR command 84 
STROMCRDAR command 161 
STRRMCRDAR command 83 
STRRTVRDAR command 160 


T 


tape media 
drive characteristics 213 
tape devices 211 

tape media management 209 


U 


Unbundle exit 293 

definition 293 

with report definition 293 
unbundle reports (UBND) 

within the spooled file 19 
usage statistics reports 139 


V 


Viewer 140 
Viewer Exit 295 


W 


WRKADMRDAR command _ 5, 20, 44, 
146, 152 

WRKCSI command 246 

WRKMEDRDAR command _ 211, 214, 
216, 218, 219, 220, 222, 225, 227, 229, 
231, 233, 235, 237, 240, 242, 244 

WRKOUTQ command 76 

WRKSECRDAR command __ 56, 62, 65 
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